FileOptions FileOptions FileOptions FileOptions Enum

Definición

Representa opciones avanzadas para crear un objeto FileStream.Represents advanced options for creating a FileStream object.

Esta enumeración tiene el atributo FlagsAttribute, que permite una combinación bit a bit de sus valores de miembro.

public enum class FileOptions
[System.Flags]
[System.Runtime.InteropServices.ComVisible(true)]
[System.Serializable]
public enum FileOptions
type FileOptions = 
Public Enum FileOptions
Herencia
Atributos

Campos

Asynchronous Asynchronous Asynchronous Asynchronous 1073741824

Indica que un archivo puede utilizarse para las operaciones de lectura y escritura asincrónicas.Indicates that a file can be used for asynchronous reading and writing.

DeleteOnClose DeleteOnClose DeleteOnClose DeleteOnClose 67108864

Indica que un archivo se elimina automáticamente cuando ya no está en uso.Indicates that a file is automatically deleted when it is no longer in use.

Encrypted Encrypted Encrypted Encrypted 16384

Indica que un archivo está cifrado y que sólo se puede descifrar utilizando la misma cuenta de usuario que la utilizada para el cifrado.Indicates that a file is encrypted and can be decrypted only by using the same user account used for encryption.

None None None None 0

Indica que no se deben usar opciones adicionales al crear un objeto FileStream .Indicates that no additional options should be used when creating a FileStream object.

RandomAccess RandomAccess RandomAccess RandomAccess 268435456

Indica que el acceso al archivo se realiza aleatoriamente.Indicates that the file is accessed randomly. El sistema puede considerar que esto es una sugerencia para optimizar el almacenamiento en caché del archivo.The system can use this as a hint to optimize file caching.

SequentialScan SequentialScan SequentialScan SequentialScan 134217728

Indica que el acceso al archivo debe ser secuencial de principio a fin.Indicates that the file is to be accessed sequentially from beginning to end. El sistema puede considerar que esto es una sugerencia para optimizar el almacenamiento en caché del archivo.The system can use this as a hint to optimize file caching. Si una aplicación mueve el puntero de archivo para obtener acceso aleatorio, puede que no se produzca un almacenamiento en caché óptimo; no obstante, la operación correcta sigue garantizada.If an application moves the file pointer for random access, optimum caching may not occur; however, correct operation is still guaranteed. Especificar esta marca puede aumentar el rendimiento en algunos casos.Specifying this flag can increase performance in some cases.

WriteThrough WriteThrough WriteThrough WriteThrough -2147483648

Indica que el sistema debe escribir en una caché intermedia e ir directamente al disco.Indicates that the system should write through any intermediate cache and go directly to disk.

Ejemplos

El ejemplo siguiente muestra cómo usar el valor asincrónico al crear una secuencia de archivos.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

Comentarios

Especificar el FileOptions.SequentialScan marca puede aumentar el rendimiento de las aplicaciones que leen los archivos de gran tamaño mediante el acceso secuencial.Specifying the FileOptions.SequentialScan flag can increase performance for applications that read large files using sequential access. Mejoras de rendimiento pueden ser incluso más evidentes para las aplicaciones que leen los archivos de gran tamaño principalmente secuencialmente, pero en ocasiones, omiten los pequeños intervalos de bytes.Performance gains can be even more noticeable for applications that read large files mostly sequentially, but occasionally skip over small ranges of bytes.

Se aplica a