File.Create Método

Referencia

Definición

Espacio de nombres:: System.IO

Ensamblados:: mscorlib.dll, System.IO.FileSystem.dll

Ensamblado:: System.IO.FileSystem.dll

Ensamblado:: System.Runtime.dll

Ensamblado:: mscorlib.dll

Ensamblado:: netstandard.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

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, Int32, FileOptions, FileSecurity)	Crea o sobrescribe un archivo en la ruta de acceso especificada, indicando un tamaño de búfer, opciones que describen cómo crear o sobrescribir el archivo y un valor que determina el control de acceso y la seguridad de auditoría del archivo.

Create(String)

Source:: File.cs

Source:: File.cs

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

Se aplica a

.NET 9 y otras versiones

Producto	Versiones
.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

Create(String, Int32)

Source:: File.cs

Source:: File.cs

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

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

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.

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

Consulte también

Se aplica a

.NET 9 y otras versiones

Producto	Versiones
.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

Create(String, Int32, FileOptions)

Source:: File.cs

Source:: File.cs

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

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

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

Se aplica a

.NET 9 y otras versiones

Producto	Versiones
.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	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

Create(String, Int32, FileOptions, FileSecurity)

Crea o sobrescribe un archivo en la ruta de acceso especificada, indicando un tamaño de búfer, opciones que describen cómo crear o sobrescribir el archivo y un valor que determina el control de acceso y la seguridad de auditoría del archivo.

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

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

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

Public Shared Function Create (path As String, bufferSize As Integer, options As FileOptions, fileSecurity As FileSecurity) 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.

fileSecurity: FileSecurity

Objeto FileSecurity que determina el control de acceso y la seguridad de auditoría del archivo.

Devoluciones

FileStream

Un archivo nuevo con el tamaño de búfer, las opciones de archivo y la seguridad de archivo especificados.

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, solo contiene 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

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

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

Importante

Este método se ha portado a .NET Core 3.1 de la siguiente forma: Create(FileInfo, FileMode, FileSystemRights, FileShare, Int32, FileOptions, FileSecurity).

Se aplica a

.NET Framework 4.8.1 y otras versiones

Producto	Versiones
.NET Framework	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

Compartir a través de

File.Create Método

Definición

Sobrecargas

Create(String)

Parámetros

Devoluciones

Excepciones

Ejemplos

Comentarios

Consulte también

Se aplica a

Create(String, Int32)

Parámetros

Devoluciones

Excepciones

Ejemplos

Comentarios

Consulte también

Se aplica a

Create(String, Int32, FileOptions)

Parámetros

Devoluciones

Excepciones

Comentarios

Se aplica a

Create(String, Int32, FileOptions, FileSecurity)

Parámetros

Devoluciones

Excepciones

Comentarios

Se aplica a

Recursos adicionales