File.Create Método

Definición

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 que proporciona acceso de lectura y escritura al archivo especificado en path.

Excepciones

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.

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().

path es null.

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

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

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

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

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 con el tamaño de búfer especificado que proporciona acceso de lectura y escritura al archivo especificado en path.

Excepciones

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.

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().

path es null.

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

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

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

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

Se aplica a

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

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

Excepciones

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.

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().

path es null.

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

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

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

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.

Se aplica a

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

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

Excepciones

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.

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().

path es null.

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

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

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

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 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