File.CreateText(String) Método

Definição

Cria ou abre um arquivo para gravar texto codificado em UTF-8.Creates or opens a file for writing UTF-8 encoded text. Se o arquivo já existir, o conteúdo dele será substituído.If the file already exists, its contents are overwritten.

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 arquivo a ser aberto para gravação.The file to be opened for writing.

Retornos

Um StreamWriter que grava no arquivo especificado usando a codificação UTF-8.A StreamWriter that writes to the specified file using UTF-8 encoding.

Exceções

O chamador não tem a permissão necessária.The caller does not have the required permission.

- ou --or- path especificou um arquivo somente leitura.path specified a file that is read-only.

- ou --or- path especificou um arquivo que está oculto.path specified a file that is hidden.

path é uma cadeia de comprimento zero, contém somente espaços em branco ou um ou mais caracteres inválidos, conforme definido por InvalidPathChars.path is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.

path é null.path is null.

O caminho especificado, o nome de arquivo, ou ambos excedem o tamanho máximo definido pelo sistema.The specified path, file name, or both exceed the system-defined maximum length.

O caminho especificado é inválido (por exemplo, ele está em uma unidade não mapeada).The specified path is invalid (for example, it is on an unmapped drive).

path está em um formato inválido.path is in an invalid format.

Exemplos

O exemplo a seguir cria um arquivo para gravação e leitura de texto.The following example creates a file for text writing and reading.

using namespace System;
using namespace System::IO;
int main()
{
   String^ path = "c:\\temp\\MyTest.txt";
   if ( !File::Exists( path ) )
   {
      
      // Create a file to write to.
      StreamWriter^ sw = File::CreateText( path );
      try
      {
         sw->WriteLine( "Hello" );
         sw->WriteLine( "And" );
         sw->WriteLine( "Welcome" );
      }
      finally
      {
         if ( sw )
                  delete (IDisposable^)sw;
      }
   }
   
   // Open the file to read from.
   StreamReader^ sr = File::OpenText( path );
   try
   {
      String^ s = "";
      while ( s = sr->ReadLine() )
      {
         Console::WriteLine( s );
      }
   }
   finally
   {
      if ( sr )
            delete (IDisposable^)sr;
   }
}
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);
            }
        }
    }
}
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

Comentários

Esse método é equivalente ao StreamWriter(String, Boolean) sobrecarga do construtor com o parâmetro append definido como false.This method is equivalent to the StreamWriter(String, Boolean) constructor overload with the append parameter set to false. Se o arquivo especificado por path não existir, ele será criado.If the file specified by path does not exist, it is created. Se o arquivo existir, seu conteúdo será substituído.If the file does exist, its contents are overwritten. Threads adicionais têm permissão para ler o arquivo enquanto ele está aberto.Additional threads are permitted to read the file while it is open.

O parâmetro path é permitido para especificar informações de caminho relativo ou absoluto.The path parameter is permitted to specify relative or absolute path information. As informações do caminho relativo são interpretadas como relativas ao diretório de trabalho atual.Relative path information is interpreted as relative to the current working directory. Para obter o diretório de trabalho atual, consulte GetCurrentDirectory.To obtain the current working directory, see GetCurrentDirectory.

Para obter uma lista de tarefas comuns de e/s, consulte tarefas comuns de e/s.For a list of common I/O tasks, see Common I/O Tasks.

Segurança

FileIOPermission
para gravar no arquivo especificado.for writing to the specified file. Enumeração associada: WriteAssociated enumeration: Write

Aplica-se a

Veja também