FileOptions Enumeración

Definición

Espacio de nombres:

System.IO

Ensamblados:

mscorlib.dll, System.IO.FileSystem.dll

Ensamblado:

System.Runtime.dll

Ensamblado:

System.IO.FileSystem.dll

Ensamblado:

mscorlib.dll

Ensamblado:

netstandard.dll

Representa opciones avanzadas para crear un objeto FileStream.

Esta enumeración admite una combinación bit a bit de sus valores de miembro.

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

Herencia

Object

ValueType

Enum

FileOptions

Atributos

FlagsAttribute ComVisibleAttribute SerializableAttribute

Campos

Asynchronous	1073741824	Indica que un archivo puede utilizarse para las operaciones de lectura y escritura asincrónicas.
DeleteOnClose	67108864	Indica que un archivo se elimina automáticamente cuando ya no está en uso.
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.
None	0	Indica que no se deben usar opciones adicionales al crear un objeto FileStream .
RandomAccess	268435456	Indica que el acceso al archivo se realiza aleatoriamente. El sistema puede considerar que esto es una sugerencia para optimizar el almacenamiento en caché del archivo.
SequentialScan	134217728	Indica que el acceso al archivo debe ser secuencial de principio a fin. El sistema puede considerar que esto es una sugerencia para optimizar el almacenamiento en caché del archivo. 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. Especificar esta marca puede aumentar el rendimiento en algunos casos.
WriteThrough	-2147483648	Indica que el sistema debe escribir en una caché intermedia e ir directamente al disco.

Ejemplos

En el ejemplo siguiente se muestra cómo usar el valor asincrónico al crear una secuencia de archivos.

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 la marca puede aumentar el FileOptions.SequentialScan rendimiento de las aplicaciones que leen archivos grandes mediante el acceso secuencial. Las ganancias de rendimiento pueden ser aún más notables para las aplicaciones que leen archivos grandes principalmente secuencialmente, pero en ocasiones omiten intervalos pequeños de bytes.