File.CreateText(String) File.CreateText(String) File.CreateText(String) File.CreateText(String) Method

Definición

Crea o abre un archivo para escribir texto con codificación UTF-8.Creates or opens a file for writing UTF-8 encoded text. Si el archivo ya existe, se sobrescribe su contenido.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 String String String

Archivo que se va a abrir para escritura.The file to be opened for writing.

Devoluciones

StreamWriter que escribe en el archivo especificado con codificación UTF-8.A StreamWriter that writes to the specified file using UTF-8 encoding.

Excepciones

El llamador no dispone del permiso requerido.The caller does not have the required permission.

O bien-or- path especificó un archivo que es de solo lectura.path specified a file that is read-only.

O bien-or- path ha especificado un archivo que está oculto.path specified a file that is hidden.

path es una cadena de longitud cero que solo contiene espacios en blanco o uno o varios caracteres no válidos definidos por InvalidPathChars.path is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.

La ruta de acceso especificada, el nombre de archivo o ambos superan la longitud máxima definida por el sistema.The specified path, file name, or both exceed the system-defined maximum length.

La ruta de acceso especificada no es válida (por ejemplo, está en una unidad no asignada).The specified path is invalid (for example, it is on an unmapped drive).

path está en un formato no válido.path is in an invalid format.

Ejemplos

En el ejemplo siguiente se crea un archivo para la lectura y escritura 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

Comentarios

Este método es equivalente a la StreamWriter(String, Boolean) sobrecarga del constructor con append el parámetro establecido falseen.This method is equivalent to the StreamWriter(String, Boolean) constructor overload with the append parameter set to false. Si el archivo especificado por path no existe, se crea.If the file specified by path does not exist, it is created. Si el archivo existe, se sobrescribe su contenido.If the file does exist, its contents are overwritten. Los subprocesos adicionales pueden leer el archivo mientras está abierto.Additional threads are permitted to read the file while it is open.

El path parámetro puede especificar información de ruta de acceso relativa o absoluta.The path parameter is permitted to specify relative or absolute path information. La información de la ruta de acceso relativa se interpreta en relación con el directorio de trabajo actual.Relative path information is interpreted as relative to the current working directory. Para obtener el directorio de trabajo actual, GetCurrentDirectoryvea.To obtain the current working directory, see GetCurrentDirectory.

Para obtener una lista de tareas de e/s comunes, consulte tareas comunes de e/s.For a list of common I/O tasks, see Common I/O Tasks.

Seguridad

FileIOPermission
para escribir en el archivo especificado.for writing to the specified file. Enumeración asociada:WriteAssociated enumeration: Write

Se aplica a

Consulte también: