File.Create Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Crea o tronca e sovrascrive un file nel percorso specificato.
Overload
| Nome | Descrizione |
|---|---|
| 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 una dimensione 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 una dimensione del buffer, opzioni che descrivono come creare o sovrascrivere il file e un valore che determina il controllo di accesso e controlla la sicurezza per il file. |
Create(String)
- Origine:
- File.cs
- Origine:
- File.cs
- 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.
Valori restituiti
Oggetto FileStream che fornisce l'accesso in lettura/scrittura al file specificato in path.
Eccezioni
Il chiamante non dispone dell'autorizzazione richiesta.
oppure
path è stato specificato un file di sola lettura.
oppure
path è stato specificato 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 eseguire una query per individuare caratteri non validi usando il metodo GetInvalidPathChars().
path è null.
Il percorso, il nome file specificato 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.
path è in un formato non valido.
Esempio
L'esempio seguente crea un file nel percorso specificato, scrive alcune informazioni nel file e legge dal file.
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 . NoneNessun altro processo o codice può accedere al file creato fino alla chiusura dell'handle di file originale.
Questo metodo equivale all'overload del Create(String, Int32) metodo usando le dimensioni predefinite del buffer di 4.096 byte.
Il path parametro è autorizzato a specificare informazioni relative o assolute sul percorso. Le informazioni sul percorso relative 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 completo in lettura/scrittura 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.
Vedi anche
- I/O di file e di flussi
- lettura di testo da un di file
- Procedura: Scrivere testo in un file
- Procedura: Leggere e scrivere in un file di dati appena creato
Si applica a
Create(String, Int32)
- Origine:
- File.cs
- Origine:
- File.cs
- 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.
Valori restituiti
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 è stato specificato un file di sola lettura.
oppure
path è stato specificato 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 eseguire una query per individuare caratteri non validi usando il metodo GetInvalidPathChars().
path è null.
Il percorso, il nome file specificato 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.
path è in un formato non valido.
Esempio
Nell'esempio seguente viene creato un file con le dimensioni del buffer specificate.
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 . NoneNessun altro processo o codice può accedere al file creato fino alla chiusura dell'handle di file originale.
Il path parametro è autorizzato a specificare informazioni relative o assolute sul percorso. Le informazioni sul percorso relative 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 completo in lettura/scrittura 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.
Vedi anche
- I/O di file e di flussi
- lettura di testo da un di file
- Procedura: Scrivere testo in un file
- Procedura: Leggere e scrivere in un file di dati appena creato
Si applica a
Create(String, Int32, FileOptions)
- Origine:
- File.cs
- Origine:
- File.cs
- Origine:
- File.cs
- Origine:
- File.cs
- Origine:
- File.cs
Crea o sovrascrive un file nel percorso specificato, specificando una dimensione 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 FileOptions valori che descrive come creare o sovrascrivere il file.
Valori restituiti
Nuovo file con le dimensioni del buffer specificate.
Eccezioni
Il chiamante non dispone dell'autorizzazione richiesta.
oppure
path è stato specificato un file di sola lettura.
oppure
path è stato specificato 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 eseguire una query per individuare caratteri non validi usando il metodo GetInvalidPathChars().
path è null.
Il percorso, il nome file specificato 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.
path è in un formato non valido.
Commenti
Il path parametro è autorizzato a specificare informazioni relative o assolute sul percorso. Le informazioni sul percorso relative 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 completo in lettura/scrittura 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.
Si applica a
Create(String, Int32, FileOptions, FileSecurity)
Crea o sovrascrive un file nel percorso specificato, specificando una dimensione del buffer, opzioni che descrivono come creare o sovrascrivere il file e un valore che determina il controllo di accesso e controlla la sicurezza 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 FileOptions valori che descrive come creare o sovrascrivere il file.
- fileSecurity
- FileSecurity
Oggetto FileSecurity che determina il controllo di accesso e controlla la sicurezza per il file.
Valori restituiti
Nuovo file con le dimensioni del buffer, le opzioni del file e la sicurezza dei file specificati.
Eccezioni
Il chiamante non dispone dell'autorizzazione richiesta.
oppure
path è stato specificato un file di sola lettura.
oppure
path è stato specificato 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 eseguire una query per individuare caratteri non validi usando il metodo GetInvalidPathChars().
path è null.
Il percorso, il nome file specificato 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.
path è in un formato non valido.
Commenti
Il path parametro è autorizzato a specificare informazioni relative o assolute sul percorso. Le informazioni sul percorso relative 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 completo in lettura/scrittura 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).