Condividi tramite


File.Create Metodo

Definizione

Crea o tronca e sovrascrive un file nel percorso specificato.

Overload

Create(String)

Crea o tronca e sovrascrive un file nel percorso specificato.

Create(String, Int32)

Crea o tronca e sovrascrive un file nel percorso specificato, specificando una dimensione del buffer.

Create(String, Int32, FileOptions)

Crea o sovrascrive un file nel percorso specificato, specificando le dimensioni del buffer e opzioni che descrivono come creare o sovrascrivere il file.

Create(String, Int32, FileOptions, FileSecurity)

Crea o sovrascrive un file nel percorso specificato, specificando le dimensioni del buffer, le opzioni che descrivono come creare o sovrascrivere il file e un valore che determina il controllo di accesso e la sicurezza di controllo per il file.

Create(String)

Origine:
File.cs
Origine:
File.cs
Origine:
File.cs

Crea o tronca e sovrascrive un file nel percorso specificato.

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

Parametri

path
String

Percorso e nome del file da creare.

Restituisce

Oggetto FileStream che fornisce l'accesso in lettura/scrittura al file specificato in path.

Eccezioni

Il chiamante non dispone dell'autorizzazione richiesta.

-oppure-

path specifica un file di sola lettura.

-oppure-

path specifica un file nascosto.

.NET Framework e versioni di .NET Core precedenti a 2.1: path è una stringa di lunghezza zero, contiene solo spazio vuoto o contiene uno o più caratteri non validi. È possibile cercare i caratteri non validi usando il metodo GetInvalidPathChars().

path è null.

Il percorso specificato, il nome file o entrambi superano la lunghezza massima definita dal sistema.

Il percorso specificato non è valido, ad esempio si trova in un'unità non mappata.

Si è verificato un errore di I/O durante la creazione del file.

Il formato di path non è valido.

Esempio

L'esempio seguente crea un file nel percorso specificato, scrive alcune informazioni nel file e legge dal file.

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

Commenti

L'oggetto FileStream creato da questo metodo ha un valore predefinito FileShare di None. Nessun altro processo o codice può accedere al file creato fino alla chiusura dell'handle di file originale.

Questo metodo equivale all'overload del metodo usando le dimensioni predefinite del Create(String, Int32) buffer di 4.096 byte.

Il path parametro è consentito per specificare informazioni relative o assolute sul percorso. Le informazioni relative sul percorso sono interpretate come relative alla directory di lavoro corrente. Per ottenere la directory di lavoro corrente, vedere GetCurrentDirectory.

Se il file specificato non esiste, viene creato; se esiste e non è di sola lettura, il contenuto viene eliminato e sovrascritto.

Per impostazione predefinita, l'accesso in lettura/scrittura completo ai nuovi file viene concesso a tutti gli utenti. Il file viene aperto con accesso in lettura/scrittura e deve essere chiuso prima di poter essere aperto da un'altra applicazione.

Per un elenco di attività di I/O comuni, vedere Attività di I/O comuni.

Vedi anche

Si applica a

Create(String, Int32)

Origine:
File.cs
Origine:
File.cs
Origine:
File.cs

Crea o tronca e sovrascrive un file nel percorso specificato, specificando una dimensione del buffer.

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

Parametri

path
String

Percorso e nome del file da creare.

bufferSize
Int32

Numero di byte memorizzati nel buffer per letture e scritture nel file.

Restituisce

Oggetto FileStream con le dimensioni del buffer specificate che fornisce l'accesso in lettura/scrittura al file specificato in path.

Eccezioni

Il chiamante non dispone dell'autorizzazione richiesta.

-oppure-

path specifica un file di sola lettura.

-oppure-

path specifica un file nascosto.

.NET Framework e versioni di .NET Core precedenti a 2.1: path è una stringa di lunghezza zero, contiene solo spazio vuoto o contiene uno o più caratteri non validi. È possibile cercare i caratteri non validi usando il metodo GetInvalidPathChars().

path è null.

Il percorso specificato, il nome file o entrambi superano la lunghezza massima definita dal sistema.

Il percorso specificato non è valido, ad esempio si trova in un'unità non mappata.

Si è verificato un errore di I/O durante la creazione del file.

Il formato di path non è valido.

Esempio

Nell'esempio seguente viene creato un file con le dimensioni del buffer specificate.

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

Commenti

L'oggetto FileStream creato da questo metodo ha un valore predefinito FileShare di None. Nessun altro processo o codice può accedere al file creato fino alla chiusura dell'handle di file originale.

Il path parametro è consentito per specificare informazioni relative o assolute sul percorso. Le informazioni relative sul percorso sono interpretate come relative alla directory di lavoro corrente. Per ottenere la directory di lavoro corrente, vedere GetCurrentDirectory.

Questo metodo equivale all'overload del FileStream(String, FileMode, FileAccess, FileShare, Int32) costruttore. Se il file specificato non esiste, viene creato; se esiste e non è di sola lettura, il contenuto viene sostituito.

Per impostazione predefinita, l'accesso in lettura/scrittura completo ai nuovi file viene concesso a tutti gli utenti. Il file viene aperto con accesso in lettura/scrittura e deve essere chiuso prima di poter essere aperto da un'altra applicazione.

Per un elenco di attività di I/O comuni, vedere Attività di I/O comuni.

Vedi anche

Si applica a

Create(String, Int32, FileOptions)

Origine:
File.cs
Origine:
File.cs
Origine:
File.cs

Crea o sovrascrive un file nel percorso specificato, specificando le dimensioni del buffer e opzioni che descrivono come creare o sovrascrivere il 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

Parametri

path
String

Percorso e nome del file da creare.

bufferSize
Int32

Numero di byte memorizzati nel buffer per letture e scritture nel file.

options
FileOptions

Uno dei valori di FileOptions che descrive come creare o sovrascrivere il file.

Restituisce

Nuovo file con le dimensioni del buffer specificate.

Eccezioni

Il chiamante non dispone dell'autorizzazione richiesta.

-oppure-

path specifica un file di sola lettura.

-oppure-

path specifica un file nascosto.

.NET Framework e versioni di .NET Core precedenti a 2.1: path è una stringa di lunghezza zero, contiene solo spazio vuoto o contiene uno o più caratteri non validi. È possibile cercare i caratteri non validi usando il metodo GetInvalidPathChars().

path è null.

Il percorso specificato, il nome file o entrambi superano la lunghezza massima definita dal sistema.

Il percorso specificato non è valido, ad esempio si trova in un'unità non mappata.

Si è verificato un errore di I/O durante la creazione del file.

Il formato di path non è valido.

Commenti

Il path parametro è consentito per specificare informazioni relative o assolute sul percorso. Le informazioni relative sul percorso sono interpretate come relative alla directory di lavoro corrente. Per ottenere la directory di lavoro corrente, vedere GetCurrentDirectory.

Questo metodo equivale all'overload del FileStream(String, FileMode, FileAccess, FileShare, Int32) costruttore. Se il file specificato non esiste, viene creato; se esiste e non è di sola lettura, il contenuto viene sostituito.

Per impostazione predefinita, l'accesso in lettura/scrittura completo ai nuovi file viene concesso a tutti gli utenti. Il file viene aperto con accesso in lettura/scrittura e deve essere chiuso prima di poter essere aperto da un'altra applicazione.

Per un elenco di attività di I/O comuni, vedere Attività di I/O comuni.

Si applica a

Create(String, Int32, FileOptions, FileSecurity)

Crea o sovrascrive un file nel percorso specificato, specificando le dimensioni del buffer, le opzioni che descrivono come creare o sovrascrivere il file e un valore che determina il controllo di accesso e la sicurezza di controllo per il 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
Public Shared Function Create (path As String, bufferSize As Integer, options As FileOptions, fileSecurity As FileSecurity) As FileStream

Parametri

path
String

Percorso e nome del file da creare.

bufferSize
Int32

Numero di byte memorizzati nel buffer per letture e scritture nel file.

options
FileOptions

Uno dei valori di FileOptions che descrive come creare o sovrascrivere il file.

fileSecurity
FileSecurity

Oggetto FileSecurity che determina il controllo di accesso e la sicurezza di controllo per il file.

Restituisce

Nuovo file con dimensioni del buffer, opzioni e sicurezza del file specificati.

Eccezioni

Il chiamante non dispone dell'autorizzazione richiesta.

-oppure-

path specifica un file di sola lettura.

-oppure-

path specifica un file nascosto.

.NET Framework e versioni di .NET Core precedenti alla 2.1: path è una stringa di lunghezza zero, contiene solo spazi vuoti o contiene uno o più caratteri non validi. È possibile cercare i caratteri non validi usando il metodo GetInvalidPathChars().

path è null.

Il percorso specificato, il nome file o entrambi superano la lunghezza massima definita dal sistema.

Il percorso specificato non è valido, ad esempio si trova in un'unità non mappata.

Si è verificato un errore di I/O durante la creazione del file.

Il formato di path non è valido.

Commenti

Il path parametro è autorizzato a specificare informazioni relative o assolute sul percorso. Le informazioni relative sul percorso sono interpretate come relative alla directory di lavoro corrente. Per ottenere la directory di lavoro corrente, vedere GetCurrentDirectory.

Questo metodo equivale all'overload del FileStream(String, FileMode, FileAccess, FileShare, Int32) costruttore. Se il file specificato non esiste, viene creato; se esiste e non è di sola lettura, il contenuto viene sostituito.

Per impostazione predefinita, l'accesso in lettura/scrittura completo ai nuovi file viene concesso a tutti gli utenti. Il file viene aperto con accesso in lettura/scrittura e deve essere chiuso prima che possa essere aperto da un'altra applicazione.

Per un elenco delle attività di I/O comuni, vedere Attività di I/O comuni.

Importante

Questo metodo è stato convertito in .NET Core 3.1 nel formato seguente: Create(FileInfo, FileMode, FileSystemRights, FileShare, Int32, FileOptions, FileSecurity).

Si applica a