FileOptions Enumerazione
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.
Rappresenta le opzioni avanzate per la creazione di un oggetto FileStream.
Questa enumerazione supporta una combinazione bit per bit dei rispettivi valori dei membri.
public enum class FileOptions[System.Flags]
public enum FileOptions[System.Flags]
[System.Runtime.InteropServices.ComVisible(true)]
[System.Serializable]
public enum FileOptions[<System.Flags>]
type FileOptions = [<System.Flags>]
[<System.Runtime.InteropServices.ComVisible(true)>]
[<System.Serializable>]
type FileOptions = Public Enum FileOptions- Ereditarietà
- Attributi
Campi
| Asynchronous | 1073741824 | Indica che è possibile utilizzare un file per la lettura e la scrittura asincrona. |
| DeleteOnClose | 67108864 | Indica l'eliminazione automatica del file quando non è più in uso. |
| Encrypted | 16384 | Indica che un file è crittografato ed è possibile decrittografarlo solamente utilizzando lo stesso account utente utilizzato per la crittografia. |
| None | 0 | Indica che non deve essere utilizzata alcuna opzione aggiuntiva quando crea un oggetto FileStream. |
| RandomAccess | 268435456 | Indica l'accesso casuale al file. Il sistema può interpretare questa situazione come hint per l'ottimizzazione della memorizzazione del file nella cache. |
| SequentialScan | 134217728 | Indica che l'accesso del file deve avvenire in modo sequenziale dall'inizio alla fine. Il sistema può interpretare questa situazione come hint per l'ottimizzazione della memorizzazione del file nella cache. Se un'applicazione sposta il puntatore a file per l'accesso casuale, la cache potrebbe non essere ottimale ma l'operazione viene comunque garantita. La scelta di questo flag in alcuni casi può migliorare le prestazioni. |
| WriteThrough | -2147483648 | Indica al sistema di ignorare le cache intermedie e di accedere direttamente al disco. |
Esempio
Nell'esempio seguente viene illustrato come usare il valore asincrono durante la creazione di un flusso di file.
using System;
using System.Text;
using System.Threading.Tasks;
using System.IO;
namespace ConsoleApplication
{
class Program
{
static void Main(string[] args)
{
WriteToFile();
}
static async void WriteToFile()
{
byte[] bytesToWrite = Encoding.Unicode.GetBytes("example text to write");
using (FileStream createdFile = File.Create("c:/Temp/testfile.txt", 4096, FileOptions.Asynchronous))
{
await createdFile.WriteAsync(bytesToWrite, 0, bytesToWrite.Length);
}
}
}
}
Imports System.IO
Imports System.Text
Module Module1
Sub Main()
WriteToFile()
End Sub
Async Sub WriteToFile()
Dim bytesToWrite = Encoding.Unicode.GetBytes("example text to write")
Using createdFile As FileStream = File.Create("c:/Temp/testfile.txt", 4096, FileOptions.Asynchronous)
Await createdFile.WriteAsync(bytesToWrite, 0, bytesToWrite.Length)
End Using
End Sub
End Module
Commenti
La specifica del flag può aumentare le prestazioni per le applicazioni che leggeno file di grandi dimensioni usando l'accesso FileOptions.SequentialScan sequenziale. I miglioramenti delle prestazioni possono essere ancora più evidenti per le applicazioni che leggono file di grandi dimensioni principalmente in sequenza, ma occasionalmente ignorano intervalli di byte di piccole dimensioni.
