Ler em inglês

Compartilhar via


File.OpenWrite(String) Método

Definição

Abre um arquivo existente ou cria um novo arquivo para gravação.

public static System.IO.FileStream OpenWrite (string path);

Parâmetros

path
String

O arquivo a ser aberto para gravação.

Retornos

Um objeto FileStream não compartilhado no caminho especificado com acesso Write.

Exceções

O chamador não tem a permissão necessária.

- ou -

path especificou um arquivo ou diretório somente leitura.

.NET Framework e versões do .NET Core anteriores à 2.1: path é uma cadeia de caracteres de comprimento zero, contém apenas espaço em branco ou contém um ou mais caracteres inválidos. Consulte caracteres inválidos usando o método GetInvalidPathChars().

path é null.

O caminho especificado, o nome de arquivo, ou ambos excedem o tamanho máximo definido pelo sistema.

O caminho especificado é inválido (por exemplo, ele está em uma unidade não mapeada).

path está em um formato inválido.

Exemplos

O exemplo a seguir abre um arquivo para leitura e gravação.

using System;
using System.IO;
using System.Text;

class Test
{
    public static void Main()
    {
        string path = @"c:\temp\MyTest.txt";

        // Open the stream and write to it.
        using (FileStream fs = File.OpenWrite(path))
        {
            Byte[] info =
                new UTF8Encoding(true).GetBytes("This is to test the OpenWrite method.");

            // Add some information to the file.
            fs.Write(info, 0, info.Length);
        }

        // Open the stream and read it back.
        using (FileStream fs = File.OpenRead(path))
        {
            byte[] b = new byte[1024];
            UTF8Encoding temp = new UTF8Encoding(true);

            while (fs.Read(b,0,b.Length) > 0)
            {
                Console.WriteLine(temp.GetString(b));
            }
        }
    }
}

Comentários

Esse método é equivalente à sobrecarga do construtor com o FileStream(String, FileMode, FileAccess, FileShare) modo de arquivo definido OpenOrCreatecomo , o acesso definido como Writee o modo de compartilhamento definido como None.

O OpenWrite método abrirá um arquivo se já existir um para o caminho do arquivo ou criará um novo arquivo se um não existir. Para um arquivo existente, ele não acrescenta o novo texto ao texto existente. Em vez disso, ele substitui os caracteres existentes pelos novos caracteres. Se você substituir uma cadeia de caracteres mais longa (como "Este é um teste do método OpenWrite") por uma cadeia de caracteres mais curta (como "Segunda execução"), o arquivo conterá uma combinação das cadeias de caracteres ("Segundo runtest do método OpenWrite").

O path parâmetro pode especificar informações de caminho relativo ou absoluto. As informações do caminho relativo são interpretadas como relativas ao diretório de trabalho atual. Para obter o diretório de trabalho atual, use o GetCurrentDirectory método .

O retornado FileStream não dá suporte à leitura. Para abrir um arquivo para leitura e gravação, use Open.

Para obter uma lista de tarefas comuns de E/S, consulte Tarefas comuns de E/S.

Aplica-se a

Produto Versões
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

Confira também