File.Create File.Create File.Create File.Create Method

Definición

Crea o sobrescribe un archivo en la ruta de acceso especificada.Creates or overwrites a file in the specified path.

Sobrecargas

Create(String) Create(String) Create(String) Create(String)

Crea o sobrescribe un archivo en la ruta de acceso especificada.Creates or overwrites a file in the specified path.

Create(String, Int32) Create(String, Int32) Create(String, Int32) Create(String, Int32)

Crea o sobrescribe un archivo en la ruta de acceso especificada, indicando un tamaño de búfer.Creates or overwrites a file in the specified path, specifying a buffer size.

Create(String, Int32, FileOptions) Create(String, Int32, FileOptions) Create(String, Int32, FileOptions) 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.Creates or overwrites a file in the specified path, specifying a buffer size and options that describe how to create or overwrite the file.

Create(String, Int32, FileOptions, FileSecurity) Create(String, Int32, FileOptions, FileSecurity) 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.Creates or overwrites a file in the specified path, specifying a buffer size, options that describe how to create or overwrite the file, and a value that determines the access control and audit security for the file.

Create(String) Create(String) Create(String) Create(String)

Crea o sobrescribe un archivo en la ruta de acceso especificada.Creates or overwrites a file in the specified path.

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

Ruta de acceso y nombre del archivo que se va a crear.The path and name of the file to create.

Devoluciones

FileStream que proporciona acceso de lectura y escritura al archivo especificado en path.A FileStream that provides read/write access to the file specified in path.

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

Se produjo un error de E/S al crear el archivoAn I/O error occurred while creating the file.

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

Ejemplos

En el ejemplo siguiente se crea un archivo en la ruta de acceso especificada, se escribe cierta información en el archivo y se lee desde el archivo.The following example creates a file in the specified path, writes some information to the file, and reads from the file.

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

int main()
{
   String^ path = "c:\\temp\\MyTest.txt";
   
   // Delete the file if it exists.
   if ( File::Exists( path ) )
   {
      File::Delete( path );
   }

   // Create the file.
   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
        {

            // Delete the file if it exists.
            if (File.Exists(path))
            {
                // Note that no lock is put on the
                // file and the possibility exists
                // that another process could do
                // something with it between
                // the calls to Exists and Delete.
                File.Delete(path);
            }

            // Create the file.
            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());
        }
    }
}
Imports System.IO
Imports System.Text

Public Class Test
  Public Shared Sub Main()
    Dim path As String = "c:\temp\MyTest.txt"

    Try

      ' Delete the file if it exists. 
      If File.Exists(path) Then
        ' Note that no lock is put on the file and the possibility exists 
        ' that another process could do something with it between 
        ' the calls to Exists and Delete.
        File.Delete(path)
      End If

      ' Create the file. 
      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 FileShare predeterminado de None; ningún otro proceso o código puede tener acceso al archivo creado hasta que se cierre el identificador de archivo original.The FileStream object created by this method has a default FileShare value of None; no other process or code can access the created file until the original file handle is closed.

Este método es equivalente a la Create(String, Int32) sobrecarga del método usando el tamaño de búfer predeterminado de 4.096 bytes.This method is equivalent to the Create(String, Int32) method overload using the default buffer size of 4,096 bytes.

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.

Si el archivo especificado no existe, se crea; Si existe y no es de solo lectura, se sobrescribe el contenido.If the specified file does not exist, it is created; if it does exist and it is not read-only, the contents are overwritten.

De forma predeterminada, el acceso completo de lectura y escritura a los nuevos archivos se concede a todos los usuarios.By default, full read/write access to new files is granted to all users. El archivo se abre con acceso de lectura y escritura y debe cerrarse para que otra aplicación pueda abrirlo.The file is opened with read/write access and must be closed before it can be opened by another application.

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 obtener permiso para leer y escribir en el archivo descrito por path el parámetro.for permission to read and write to the file described by the path parameter. Acción de seguridad Demand:.Security action: Demand. Enumeraciones asociadas: Read,WriteAssociated enumerations: Read, Write

Consulte también:

Create(String, Int32) Create(String, Int32) Create(String, Int32) Create(String, Int32)

Crea o sobrescribe un archivo en la ruta de acceso especificada, indicando un tamaño de búfer.Creates or overwrites a file in the specified path, specifying a buffer size.

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

Ruta de acceso y nombre del archivo que se va a crear.The path and name of the file to create.

bufferSize
Int32 Int32 Int32 Int32

Número de bytes almacenados en el búfer para leer y escribir en el archivo.The number of bytes buffered for reads and writes to the file.

Devoluciones

FileStream con el tamaño de búfer especificado que proporciona acceso de lectura y escritura al archivo especificado en path.A FileStream with the specified buffer size that provides read/write access to the file specified in path.

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

Se produjo un error de E/S al crear el archivoAn I/O error occurred while creating the file.

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

Ejemplos

En el ejemplo siguiente se crea un archivo con el tamaño de búfer especificado.The following example creates a file with the specified buffer size.

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

int main()
{
   String^ path = "c:\\temp\\MyTest.txt";
   
   // Delete the file if it exists.
   if ( File::Exists( path ) )
   {
      File::Delete( path );
   }
   
   // Create the file.
   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";

        // Delete the file if it exists.
        if (File.Exists(path)) 
        {
            File.Delete(path);
        }

        // Create the file.
        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);
            }
        }
    }
}
Imports System.IO
Imports System.Text

Public Class Test
  Public Shared Sub Main()
    Dim path As String = "c:\temp\MyTest.txt"

    Try

      ' Delete the file if it exists. 
      If File.Exists(path) Then
        ' Note that no lock is put on the file and the possibility exists 
        ' that another process could do something with it between 
        ' the calls to Exists and Delete.
        File.Delete(path)
      End If

      ' Create the file. 
      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 FileShare predeterminado de None; ningún otro proceso o código puede tener acceso al archivo creado hasta que se cierre el identificador de archivo original.The FileStream object created by this method has a default FileShare value of None; no other process or code can access the created file until the original file handle is closed.

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.

Este método es equivalente a la FileStream(String, FileMode, FileAccess, FileShare, Int32) sobrecarga del constructor.This method is equivalent to the FileStream(String, FileMode, FileAccess, FileShare, Int32) constructor overload. Si el archivo especificado no existe, se crea; Si existe y no es de solo lectura, se sobrescribe el contenido.If the specified file does not exist, it is created; if it does exist and it is not read-only, the contents are overwritten.

De forma predeterminada, el acceso completo de lectura y escritura a los nuevos archivos se concede a todos los usuarios.By default, full read/write access to new files is granted to all users. El archivo se abre con acceso de lectura y escritura y debe cerrarse para que otra aplicación pueda abrirlo.The file is opened with read/write access and must be closed before it can be opened by another application.

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 obtener permiso para leer y escribir en el archivo descrito por path el parámetro.for permission to read and write to the file described by the path parameter. Acción de seguridad: Bajo.Security action: Demand. Enumeraciones asociadas: Read,WriteAssociated enumerations: Read, Write

Consulte también:

Create(String, Int32, FileOptions) Create(String, Int32, FileOptions) Create(String, Int32, FileOptions) 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.Creates or overwrites a file in the specified path, specifying a buffer size and options that describe how to create or overwrite the file.

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

Ruta de acceso y nombre del archivo que se va a crear.The path and name of the file to create.

bufferSize
Int32 Int32 Int32 Int32

Número de bytes almacenados en el búfer para leer y escribir en el archivo.The number of bytes buffered for reads and writes to the file.

options
FileOptions FileOptions FileOptions FileOptions

Uno de los valores de FileOptions que describe cómo crear o sobrescribir el archivo.One of the FileOptions values that describes how to create or overwrite the file.

Devoluciones

Un archivo nuevo con el tamaño de búfer especificado.A new file with the specified buffer size.

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.

Se produjo un error de E/S al crear el archivoAn I/O error occurred while creating the file.

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

Comentarios

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.

Este método es equivalente a la FileStream(String, FileMode, FileAccess, FileShare, Int32) sobrecarga del constructor.This method is equivalent to the FileStream(String, FileMode, FileAccess, FileShare, Int32) constructor overload. Si el archivo especificado no existe, se crea; Si existe y no es de solo lectura, se sobrescribe el contenido.If the specified file does not exist, it is created; if it does exist and it is not read-only, the contents are overwritten.

De forma predeterminada, el acceso completo de lectura y escritura a los nuevos archivos se concede a todos los usuarios.By default, full read/write access to new files is granted to all users. El archivo se abre con acceso de lectura y escritura y debe cerrarse para que otra aplicación pueda abrirlo.The file is opened with read/write access and must be closed before it can be opened by another application.

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 obtener permiso para leer y escribir en el archivo descrito por path el parámetro.for permission to read and write to the file described by the path parameter. Acción de seguridad: Bajo.Security action: Demand. Enumeraciones asociadas: Read,WriteAssociated enumerations: Read, Write

Create(String, Int32, FileOptions, FileSecurity) Create(String, Int32, FileOptions, FileSecurity) 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.Creates or overwrites a file in the specified path, specifying a buffer size, options that describe how to create or overwrite the file, and a value that determines the access control and audit security for the file.

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

Parámetros

path
String String String String

Ruta de acceso y nombre del archivo que se va a crear.The path and name of the file to create.

bufferSize
Int32 Int32 Int32 Int32

Número de bytes almacenados en el búfer para leer y escribir en el archivo.The number of bytes buffered for reads and writes to the file.

options
FileOptions FileOptions FileOptions FileOptions

Uno de los valores de FileOptions que describe cómo crear o sobrescribir el archivo.One of the FileOptions values that describes how to create or overwrite the file.

fileSecurity
FileSecurity FileSecurity FileSecurity FileSecurity

Uno de los valores de FileSecurity que determina el control de acceso y la seguridad de auditoría del archivo.One of the FileSecurity values that determines the access control and audit security for the file.

Devoluciones

Un archivo nuevo con el tamaño de búfer, las opciones de archivo y la seguridad de archivo especificados.A new file with the specified buffer size, file options, and file security.

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

Se produjo un error de E/S al crear el archivoAn I/O error occurred while creating the file.

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

Comentarios

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.

Este método es equivalente a la FileStream(String, FileMode, FileAccess, FileShare, Int32) sobrecarga del constructor.This method is equivalent to the FileStream(String, FileMode, FileAccess, FileShare, Int32) constructor overload. Si el archivo especificado no existe, se crea; Si existe y no es de solo lectura, se sobrescribe el contenido.If the specified file does not exist, it is created; if it does exist and it is not read-only, the contents are overwritten.

De forma predeterminada, el acceso completo de lectura y escritura a los nuevos archivos se concede a todos los usuarios.By default, full read/write access to new files is granted to all users. El archivo se abre con acceso de lectura y escritura y debe cerrarse para que otra aplicación pueda abrirlo.The file is opened with read/write access and must be closed before it can be opened by another application.

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 obtener permiso para leer y escribir en el archivo descrito por path el parámetro.for permission to read and write to the file described by the path parameter. Acción de seguridad: Bajo.Security action: Demand. Enumeraciones asociadas: Read,WriteAssociated enumerations: Read, Write

Se aplica a