File.Create Método

Definición

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

Sobrecargas

Nombre Description
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 en la ruta de acceso especificada, especificando un tamaño y opciones de búfer 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, especificando 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
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

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

Excepciones

El autor de la llamada no tiene el permiso necesario.

O bien

path especificó un archivo que es de solo lectura.

O bien

path especificó un archivo que está oculto.

Versiones de .NET Framework y .NET Core anteriores a la 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 caracteres no válidos mediante 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).

Error de E/S al crear el archivo.

path tiene 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 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 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 antes de que otra aplicación pueda abrirlo.

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

Consulte también

Se aplica a

Create(String, Int32)

Source:
File.cs
Source:
File.cs
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 búfer para lecturas y escrituras en el archivo.

Devoluciones

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

Excepciones

El autor de la llamada no tiene el permiso necesario.

O bien

path especificó un archivo que es de solo lectura.

O bien

path especificó un archivo que está oculto.

Versiones de .NET Framework y .NET Core anteriores a la 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 caracteres no válidos mediante 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).

Error de E/S al crear el archivo.

path tiene un formato no válido.

Ejemplos

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

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, el contenido se reemplaza.

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 antes de que otra aplicación pueda abrirlo.

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

Consulte también

Se aplica a

Create(String, Int32, FileOptions)

Source:
File.cs
Source:
File.cs
Source:
File.cs
Source:
File.cs
Source:
File.cs

Crea o sobrescribe un archivo en la ruta de acceso especificada, especificando un tamaño y opciones de búfer 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 búfer para lecturas y escrituras en el archivo.

options
FileOptions

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

Devoluciones

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

Excepciones

El autor de la llamada no tiene el permiso necesario.

O bien

path especificó un archivo que es de solo lectura.

O bien

path especificó un archivo que está oculto.

Versiones de .NET Framework y .NET Core anteriores a la 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 caracteres no válidos mediante 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, se encuentra en una unidad sin asignar.

Error de E/S al crear el archivo.

path tiene 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, el contenido se reemplaza.

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 antes de que otra aplicación pueda abrirlo.

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

Se aplica a

Create(String, Int32, FileOptions, FileSecurity)

Crea o sobrescribe un archivo en la ruta de acceso especificada, especificando 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 búfer para lecturas y escrituras en el archivo.

options
FileOptions

Uno de los FileOptions valores 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

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

Excepciones

El autor de la llamada no tiene el permiso necesario.

O bien

path especificó un archivo que es de solo lectura.

O bien

path especificó un archivo que está oculto.

Versiones de .NET Framework y .NET Core anteriores a la 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 caracteres no válidos mediante 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).

Error de E/S al crear el archivo.

path tiene 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, el contenido se reemplaza.

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 antes de que otra aplicación pueda abrirlo.

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

Importante

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

Se aplica a