File.Create Método

Definición

Espacio de nombres:

System.IO

Ensamblado:

System.Runtime.dll

Crea o trunca y sobrescribe un archivo en la ruta de acceso especificada.

Sobrecargas

Create(String)	Crea o trunca y sobrescribe un archivo en la ruta de acceso especificada.
Create(String, Int32)	Crea o trunca y sobrescribe un archivo en la ruta de acceso especificada, especificando un tamaño de búfer.
Create(String, Int32, FileOptions)	Crea o sobrescribe un archivo de la ruta de acceso especificada, indicando un tamaño de búfer y opciones que describen cómo crear o sobrescribir el archivo.

Create(String)

Source:

File.cs

Crea o trunca y sobrescribe un archivo en la ruta de acceso especificada.

public:
 static System::IO::FileStream ^ Create(System::String ^ path);

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

static member Create : string -> System.IO.FileStream

Public Shared Function Create (path As String) As FileStream

Parámetros

path

String

Ruta de acceso y nombre del archivo que se va a crear.

Devoluciones

FileStream

FileStream que proporciona acceso de lectura y escritura al archivo especificado en path.

Excepciones

UnauthorizedAccessException

El llamador no dispone del permiso requerido.

o bien

path especificó un archivo que es de solo lectura.

o bien

path ha especificado un archivo que está oculto.

ArgumentException

Versiones de .NET Framework y .NET Core anteriores a 2.1: path es una cadena de longitud cero, contiene solo espacios en blanco o contiene uno o varios caracteres no válidos. Puede consultar los caracteres no válidos con el método GetInvalidPathChars().

ArgumentNullException

path es null.

PathTooLongException

La ruta de acceso especificada, el nombre de archivo o ambos superan la longitud máxima definida por el sistema.

DirectoryNotFoundException

La ruta de acceso especificada no es válida (por ejemplo, está en una unidad no asignada).

IOException

Se produjo un error de E/S al crear el archivo

NotSupportedException

path está en un formato no válido.

Ejemplos

En el ejemplo siguiente se crea un archivo en la ruta de acceso especificada, se escribe información en el archivo y se lee del archivo .

using namespace System;
using namespace System::IO;
using namespace System::Text;

int main()
{
   String^ path = "c:\\temp\\MyTest.txt";
   
   // Create the file, or overwrite if the file exists.
   FileStream^ fs = File::Create( path );
   try
   {
      array<Byte>^info = (gcnew UTF8Encoding( true ))->GetBytes( "This is some text in the file." );
      
      // Add some information to the file.
      fs->Write( info, 0, info->Length );
   }
   finally
   {
      if ( fs )
            delete (IDisposable^)fs;
   }

   // Open the stream and read it back.
   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;
using System.Text;

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

        try
        {
            // Create the file, or overwrite if the file exists.
            using (FileStream fs = File.Create(path))
            {
                byte[] info = new UTF8Encoding(true).GetBytes("This is some text in the file.");
                // Add some information to the file.
                fs.Write(info, 0, info.Length);
            }

            // Open the stream and read it back.
            using (StreamReader sr = File.OpenText(path))
            {
                string s = "";
                while ((s = sr.ReadLine()) != null)
                {
                    Console.WriteLine(s);
                }
            }
        }

        catch (Exception ex)
        {
            Console.WriteLine(ex.ToString());
        }
    }
}

open System.IO
open System.Text

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

// Create the file, or overwrite if the file exists.
do
    use fs = File.Create path

    let info =
        UTF8Encoding(true)
            .GetBytes "This is some text in the file."
    // Add some information to the file.
    fs.Write(info, 0, info.Length)

// Open the stream and read it back.
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"

    Try
      ' Create the file, or overwrite if the file exists.
      Using fs As FileStream = File.Create(path)
        Dim info As Byte() = New UTF8Encoding(True).GetBytes("This is some text in the file.")

        ' Add some information to the file.
        fs.Write(info, 0, info.Length)
      End Using

      ' Open the stream and read it back. 
      Using sr As StreamReader = File.OpenText(path)
        Do While sr.Peek() >= 0
          Console.WriteLine(sr.ReadLine())
        Loop
      End Using

    Catch ex As Exception
      Console.WriteLine(ex.ToString())
    End Try

  End Sub
End Class

Comentarios

El FileStream objeto creado por este método tiene un valor predeterminado FileShare de None; ningún otro proceso o código puede tener acceso al archivo creado hasta que se cierre el identificador de archivo original.

Este método es equivalente a la sobrecarga del Create(String, Int32) método mediante el tamaño de búfer predeterminado de 4096 bytes.

El path parámetro puede especificar información de ruta de acceso relativa o absoluta. La información de ruta de acceso relativa se interpreta como relativa al directorio de trabajo actual. Para obtener el directorio de trabajo actual, consulte GetCurrentDirectory.

Si el archivo especificado no existe, se crea; si existe y no es de solo lectura, el contenido se elimina y se sobrescribe.

De forma predeterminada, se concede acceso completo de lectura y escritura a los nuevos archivos a todos los usuarios. El archivo se abre con acceso de lectura y escritura y debe cerrarse para poder abrirlo otra aplicación.

Para obtener una lista de las tareas de E/S comunes, consulte Tareas de E/S comunes.

Consulte también

• E/S de archivos y secuencias
• Leer texto de un archivo
• Cómo: Escribir texto en un archivo
• Cómo: Leer y escribir en un archivo de datos recién creado

Create(String, Int32)

Source:

File.cs

Crea o trunca y sobrescribe un archivo en la ruta de acceso especificada, especificando un tamaño de búfer.

public:
 static System::IO::FileStream ^ Create(System::String ^ path, int bufferSize);

public static System.IO.FileStream Create (string path, int bufferSize);

static member Create : string * int -> System.IO.FileStream

Public Shared Function Create (path As String, bufferSize As Integer) As FileStream

Parámetros

path

String

Ruta de acceso y nombre del archivo que se va a crear.

bufferSize

Int32

Número de bytes almacenados en el búfer para leer y escribir en el archivo.

Devoluciones

FileStream

FileStream con el tamaño de búfer especificado que proporciona acceso de lectura y escritura al archivo especificado en path.

Excepciones

UnauthorizedAccessException

El llamador no dispone del permiso requerido.

o bien

path especificó un archivo que es de solo lectura.

o bien

path ha especificado un archivo que está oculto.

ArgumentException

Versiones de .NET Framework y .NET Core anteriores a 2.1: path es una cadena de longitud cero, contiene solo espacios en blanco o contiene uno o varios caracteres no válidos. Puede consultar los caracteres no válidos con el método GetInvalidPathChars().

ArgumentNullException

path es null.

PathTooLongException

La ruta de acceso especificada, el nombre de archivo o ambos superan la longitud máxima definida por el sistema.

DirectoryNotFoundException

La ruta de acceso especificada no es válida (por ejemplo, está en una unidad no asignada).

IOException

Se produjo un error de E/S al crear el archivo

NotSupportedException

path está en un formato no válido.

Ejemplos

En el ejemplo siguiente se crea un archivo con el tamaño de búfer especificado.

using namespace System;
using namespace System::IO;
using namespace System::Text;

int main()
{
   String^ path = "c:\\temp\\MyTest.txt";
   
   // Create the file, or overwrite if the file exists.
   FileStream^ fs = File::Create( path, 1024 );
   try
   {
      array<Byte>^info = (gcnew UTF8Encoding( true ))->GetBytes( "This is some text in the file." );
      
      // Add some information to the file.
      fs->Write( info, 0, info->Length );
   }
   finally
   {
      if ( fs )
            delete (IDisposable^)fs;
   }

   // Open the stream and read it back.
   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;
using System.Text;

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

        // Create the file, or overwrite if the file exists.
        using (FileStream fs = File.Create(path, 1024))
        {
            byte[] info = new UTF8Encoding(true).GetBytes("This is some text in the file.");
            // Add some information to the file.
            fs.Write(info, 0, info.Length);
        }

        // Open the stream and read it back.
        using (StreamReader sr = File.OpenText(path))
        {
            string s = "";
            while ((s = sr.ReadLine()) != null)
            {
                Console.WriteLine(s);
            }
        }
    }
}

open System.IO
open System.Text

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

// Create the file, or overwrite if the file exists.
do
    use fs = File.Create(path, 1024)

    let info =
        UTF8Encoding(true)
            .GetBytes "This is some text in the file."
    // Add some information to the file.
    fs.Write(info, 0, info.Length)

// Open the stream and read it back.
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"

    Try
      ' Create the file, or overwrite if the file exists.
      Using fs As FileStream = File.Create(path, 1024)
        Dim info As Byte() = New UTF8Encoding(True).GetBytes("This is some text in the file.")

        ' Add some information to the file.
        fs.Write(info, 0, info.Length)
      End Using

      ' Open the stream and read it back. 
      Using sr As StreamReader = File.OpenText(path)
        Do While sr.Peek() >= 0
          Console.WriteLine(sr.ReadLine())
        Loop
      End Using

    Catch ex As Exception
      Console.WriteLine(ex.ToString())
    End Try

  End Sub
End Class

Comentarios

El FileStream objeto creado por este método tiene un valor predeterminado FileShare de None; ningún otro proceso o código puede tener acceso al archivo creado hasta que se cierre el identificador de archivo original.

El path parámetro puede especificar información de ruta de acceso relativa o absoluta. La información de ruta de acceso relativa se interpreta como relativa al directorio de trabajo actual. Para obtener el directorio de trabajo actual, consulte GetCurrentDirectory.

Este método es equivalente a la sobrecarga del FileStream(String, FileMode, FileAccess, FileShare, Int32) constructor. Si el archivo especificado no existe, se crea; si existe y no es de solo lectura, se reemplaza el contenido.

De forma predeterminada, se concede acceso completo de lectura y escritura a los nuevos archivos a todos los usuarios. El archivo se abre con acceso de lectura y escritura y debe cerrarse para poder abrirlo otra aplicación.

Para obtener una lista de las tareas de E/S comunes, consulte Tareas de E/S comunes.

Consulte también

• E/S de archivos y secuencias
• Leer texto de un archivo
• Cómo: Escribir texto en un archivo
• Cómo: Leer y escribir en un archivo de datos recién creado

Create(String, Int32, FileOptions)

Source:

File.cs

Crea o sobrescribe un archivo de la ruta de acceso especificada, indicando un tamaño de búfer y opciones que describen cómo crear o sobrescribir el archivo.

public:
 static System::IO::FileStream ^ Create(System::String ^ path, int bufferSize, System::IO::FileOptions options);

public static System.IO.FileStream Create (string path, int bufferSize, System.IO.FileOptions options);

static member Create : string * int * System.IO.FileOptions -> System.IO.FileStream

Public Shared Function Create (path As String, bufferSize As Integer, options As FileOptions) As FileStream

Parámetros

path

String

Ruta de acceso y nombre del archivo que se va a crear.

bufferSize

Int32

Número de bytes almacenados en el búfer para leer y escribir en el archivo.

options

FileOptions

Uno de los valores de FileOptions que describe cómo crear o sobrescribir el archivo.

Devoluciones

FileStream

Un archivo nuevo con el tamaño de búfer especificado.

Excepciones

UnauthorizedAccessException

El llamador no dispone del permiso requerido.

o bien

path especificó un archivo que es de solo lectura.

o bien

path ha especificado un archivo que está oculto.

ArgumentException

Versiones de .NET Framework y .NET Core anteriores a 2.1: path es una cadena de longitud cero, contiene solo espacios en blanco o contiene uno o varios caracteres no válidos. Puede consultar los caracteres no válidos con el método GetInvalidPathChars().

ArgumentNullException

path es null.

PathTooLongException

La ruta de acceso especificada, el nombre de archivo o ambos superan la longitud máxima definida por el sistema.

DirectoryNotFoundException

La ruta de acceso especificada no es válida (por ejemplo, está en una unidad no asignada).

IOException

Se produjo un error de E/S al crear el archivo

NotSupportedException

path está en un formato no válido.

Comentarios

El path parámetro puede especificar información de ruta de acceso relativa o absoluta. La información de ruta de acceso relativa se interpreta como relativa al directorio de trabajo actual. Para obtener el directorio de trabajo actual, consulte GetCurrentDirectory.

Este método es equivalente a la sobrecarga del FileStream(String, FileMode, FileAccess, FileShare, Int32) constructor. Si el archivo especificado no existe, se crea; si existe y no es de solo lectura, se reemplaza el contenido.

De forma predeterminada, se concede acceso completo de lectura y escritura a los nuevos archivos a todos los usuarios. El archivo se abre con acceso de lectura y escritura y debe cerrarse para poder abrirlo otra aplicación.

Para obtener una lista de las tareas de E/S comunes, consulte Tareas de E/S comunes.