FileOptions Énumération

Définition

Représente des options avancées pour créer un objet FileStream.Represents advanced options for creating a FileStream object.

Cette énumération a un attribut FlagsAttribute qui permet une combinaison au niveau du bit de ses valeurs membres.

public enum class FileOptions
[System.Flags]
public enum FileOptions
public enum FileOptions
[System.Flags]
[System.Runtime.InteropServices.ComVisible(true)]
[System.Serializable]
public enum FileOptions
type FileOptions = 
Public Enum FileOptions
Héritage
FileOptions
Attributs

Champs

Asynchronous 1073741824

Indique qu’un fichier peut être utilisé pour la lecture et l’écriture asynchrones.Indicates that a file can be used for asynchronous reading and writing.

DeleteOnClose 67108864

Indique qu’un fichier est automatiquement supprimé quand il n’est plus en cours d’utilisation.Indicates that a file is automatically deleted when it is no longer in use.

Encrypted 16384

Indique qu’un fichier est chiffré et qu’il peut être déchiffré uniquement en utilisant le même compte d’utilisateur que celui utilisé pour le chiffrement.Indicates that a file is encrypted and can be decrypted only by using the same user account used for encryption.

None 0

Indique qu’aucune option supplémentaire ne doit être utilisée au moment de la création d’un objet FileStream.Indicates that no additional options should be used when creating a FileStream object.

RandomAccess 268435456

Indique que le fichier est accessible aléatoirement.Indicates that the file is accessed randomly. Le système peut utiliser cette indication pour optimiser la mise en cache du fichier.The system can use this as a hint to optimize file caching.

SequentialScan 134217728

Indique que le fichier doit être accessible de manière séquentielle du début à la fin.Indicates that the file is to be accessed sequentially from beginning to end. Le système peut utiliser cette indication pour optimiser la mise en cache du fichier.The system can use this as a hint to optimize file caching. Si une application déplace le pointeur de fichier pour l’accès aléatoire, une mise en cache optimale peut ne pas se produire ; toutefois, une opération correcte est garantie.If an application moves the file pointer for random access, optimum caching may not occur; however, correct operation is still guaranteed. La spécification de cet indicateur peut augmenter les performances dans certains cas.Specifying this flag can increase performance in some cases.

WriteThrough -2147483648

Indique que le système doit écrire dans n’importe quel cache intermédiaire et aller directement au disque.Indicates that the system should write through any intermediate cache and go directly to disk.

Exemples

L’exemple suivant montre comment utiliser la valeur asynchrone lors de la création d’un flux de fichier.The following example shows how to use the Asynchronous value when creating a file stream.

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

Remarques

La spécification de l’indicateur FileOptions.SequentialScan peut augmenter les performances des applications qui lisent des fichiers volumineux à l’aide d’un accès séquentiel.Specifying the FileOptions.SequentialScan flag can increase performance for applications that read large files using sequential access. Les gains de performances peuvent être encore plus perceptibles pour les applications qui lisent des fichiers volumineux de manière séquentielle, mais qui ignorent parfois de petites plages d’octets.Performance gains can be even more noticeable for applications that read large files mostly sequentially, but occasionally skip over small ranges of bytes.

S’applique à