File.CreateText(String) Método

Definição

Espaço de Nomes:
System.IO
Assemblagens:
mscorlib.dll, System.IO.FileSystem.dll
Assemblagens:
netstandard.dll, System.Runtime.dll
Assemblagens:
netstandard.dll, System.IO.FileSystem.dll
Assemblagens:
netstandard.dll, System.IO.FileSystem.dll, System.Runtime.dll
Assemblagem:
System.IO.FileSystem.dll
Assemblagem:
mscorlib.dll
Assemblagem:
netstandard.dll
Origem:
File.cs
Origem:
File.cs
Origem:
File.cs
Origem:
File.cs
Origem:
File.cs

Cria ou abre um ficheiro para escrever texto codificado em UTF-8. Se o ficheiro já existir, o seu conteúdo é substituído.

public:
 static System::IO::StreamWriter ^ CreateText(System::String ^ path);
public static System.IO.StreamWriter CreateText(string path);
static member CreateText : string -> System.IO.StreamWriter
Public Shared Function CreateText (path As String) As StreamWriter

Parâmetros

path
String

O dossiê a abrir para escrito.

Devoluções

StreamWriter

A StreamWriter que escreve no ficheiro especificado usando codificação UTF-8.

Exceções

UnauthorizedAccessException

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

-ou-

path especificou um ficheiro que é apenas leitura.

-ou-

path especificou um ficheiro que está oculto.

ArgumentException

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

ArgumentNullException

path é null.

PathTooLongException

O caminho especificado, nome do ficheiro ou ambos excedem o comprimento máximo definido pelo sistema.

DirectoryNotFoundException

O caminho especificado é inválido (por exemplo, está num disco não mapeado).

NotSupportedException

path está num formato inválido.

Exemplos

O exemplo seguinte cria um ficheiro para escrita e leitura de texto.

using System;
using System.IO;

class Test
{
    public static void Main()
    {
        string path = @"c:\temp\MyTest.txt";
        if (!File.Exists(path))
        {
            // Create a file to write to.
            using (StreamWriter sw = File.CreateText(path))
            {
                sw.WriteLine("Hello");
                sw.WriteLine("And");
                sw.WriteLine("Welcome");
            }	
        }

        // Open the file to read from.
        using (StreamReader sr = File.OpenText(path))
        {
            string s = "";
            while ((s = sr.ReadLine()) != null)
            {
                Console.WriteLine(s);
            }
        }
    }
}

open System.IO

let path = @"c:\temp\MyTest.txt"

if File.Exists path |> not then
    // Create a file to write to.
    use sw = File.CreateText path
    sw.WriteLine "Hello"
    sw.WriteLine "Welcome"

// Open the file to read from.
do
    use sr = File.OpenText path
    let mutable s = sr.ReadLine()

    while isNull s |> not do
        printfn $"{s}"
        s <- sr.ReadLine()

Imports System.IO
Imports System.Text

Public Class Test
  Public Shared Sub Main()
    Dim path As String = "c:\temp\MyTest.txt"

    If Not File.Exists(path) Then
      ' Create a file to write to. 
      Using sw As StreamWriter = File.CreateText(path)
        sw.WriteLine("Hello")
        sw.WriteLine("And")
        sw.WriteLine("Welcome")
      End Using
    End If

    ' Open the file to read from. 
    Using sr As StreamReader = File.OpenText(path)
      Do While sr.Peek() >= 0
        Console.WriteLine(sr.ReadLine())
      Loop
    End Using

  End Sub
End Class

Observações

Este método é equivalente à StreamWriter(String, Boolean) sobrecarga do construtor com o append parâmetro definido em false. Se o ficheiro especificado por path não existir, é criado. Se o ficheiro existir, o seu conteúdo é substituído. Tópicos adicionais são permitidos para ler o ficheiro enquanto este está aberto.

O path parâmetro pode especificar informação relativa ou absoluta do caminho. A informação relativa do caminho é interpretada como relativa ao diretório de trabalho atual. Para obter o diretório de trabalho atual, veja GetCurrentDirectory.

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

Aplica-se a

Ver também