FileMode Enumerazione

Definizione

Spazio dei nomi:

System.IO

Assembly:

System.Runtime.dll

Specifica le modalità di apertura di un file da parte del sistema operativo.

public enum class FileMode

public enum FileMode

type FileMode = 

Public Enum FileMode

Ereditarietà

Object

ValueType

Enum

FileMode

Campi

Append	6	Apre il file, se esiste, e si sposta alla fine del file oppure crea un nuovo file. Richiede l'autorizzazione Append. FileMode.Append può essere utilizzata solo insieme a FileAccess.Write. Il tentativo di spostamento in una posizione precedente alla fine del file comporterà la generazione di un'eccezione IOException. Qualsiasi tentativo di lettura non riuscirà e comporterà la generazione di un'eccezione NotSupportedException.
Create	2	Specifica che il sistema operativo deve creare un nuovo file. Se il file esiste già, verrà sovrascritto. Richiede l'autorizzazione Write. FileMode.Create equivale a richiedere l'utilizzo di CreateNew nel caso in cui il file non esista e di Truncate in caso contrario. Se il file esiste già ma è nascosto, viene generata l'eccezione UnauthorizedAccessException.
CreateNew	1	Specifica che il sistema operativo deve creare un nuovo file. Richiede l'autorizzazione Write. Se il file esiste già, viene generata un'eccezione IOException.
Open	3	Specifica che il sistema operativo deve aprire un file esistente. La possibilità di aprire il file dipende dal valore specificato dall'enumerazione FileAccess. Un'eccezione FileNotFoundException viene generata se il file non esiste.
OpenOrCreate	4	Specifica che il sistema operativo deve aprire un file, se esistente. In caso contrario, deve indica di creare un nuovo file. Se il file viene aperto con FileAccess.Read, è necessaria l'autorizzazione Read. Se l'accesso al file è FileAccess.Write, sarà necessaria l'autorizzazione Write. Se il file viene aperto con FileAccess.ReadWrite, saranno necessarie le autorizzazioni Read e Write.
Truncate	5	Specifica che il sistema operativo deve aprire un file esistente. Se il file è aperto, deve essere troncato in modo che la sua dimensione sia uguale a zero byte. Richiede l'autorizzazione Write. Qualsiasi tentativo di lettura di un file aperto con FileMode.Truncate genera un'eccezione ArgumentException.

Esempio

Il costruttore seguente FileStream apre un file esistente (FileMode.Open).

FileStream^ s2 = gcnew FileStream( name, FileMode::Open, FileAccess::Read, FileShare::Read );

FileStream s2 = new FileStream(name, FileMode.Open, FileAccess.Read, FileShare.Read);

Dim s2 As New FileStream(name, FileMode.Open, FileAccess.Read, FileShare.Read)

Commenti

Per un esempio di creazione di un file e scrittura di testo in un file, vedere Procedura: Scrivere testo in un file. Per un esempio di lettura del testo da un file, vedere Procedura: Leggere testo da un file. Per un esempio di lettura e scrittura in un file binario, vedere Procedura: Leggere e scrivere in un file di dati appena creato.

Un FileMode parametro viene specificato in molti costruttori per FileStream, IsolatedStorageFileStreame nei Open metodi di e FileInfo per controllare la modalità di File apertura di un file.

FileMode i parametri controllano se un file viene sovrascritto, creato, aperto o una combinazione di tali file. Usare Open per aprire un file esistente. Per accodare a un file, usare Append. Per troncare un file o creare un file se non esiste, usare Create.

Vedi anche

• Open(String, FileMode)
• Open(FileMode)
• FileStream
• IsolatedStorageFileStream
• I/O di file e Stream
• Procedura: Leggere testo da un file
• Procedura: Scrivere un testo in un file
• Procedura: Leggere e scrivere su un file di dati appena creato