語言

FileOptions 列舉

定義

命名空間:
System.IO
組件:
mscorlib.dll, System.IO.FileSystem.dll
組件:
netstandard.dll, System.Runtime.dll
組件:
System.IO.FileSystem.dll
組件:
System.Runtime.dll
組件:
mscorlib.dll
組件:
netstandard.dll
來源:
FileOptions.cs
來源:
FileOptions.cs
來源:
ManualResetEventSlim.cs

表示用於建立 FileStream 對象的進階選項。

此列舉支援其成員值的位元組合。

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
繼承
Object
ValueType
Enum
FileOptions
屬性
FlagsAttribute ComVisibleAttribute SerializableAttribute

欄位

名稱 值 Description
WriteThrough -2147483648

表示系統應透過任一中介快取寫入，並直接寫入磁碟。
None 0

表示建立 FileStream 物件時不應使用額外選項。
Encrypted 16384

表示檔案已被加密，且只能使用相同的使用者帳號來解密。
DeleteOnClose 67108864

表示當檔案不再使用時會自動刪除。
SequentialScan 134217728

表示該檔案從頭到尾依序存取。 系統可使用這個做為最佳化檔案快取的提示。 若應用程式移動檔案指標以進行隨機存取，可能無法達成最佳快取;然而，正確操作仍是有保證的。 指定此旗幟在某些情況下能提升效能。
RandomAccess 268435456

表示檔案是隨機存取的。 系統可使用這個做為最佳化檔案快取的提示。
Asynchronous 1073741824

表示檔案可用於非同步讀寫。

範例

以下範例說明如何在建立檔案串流時使用非同步值。

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

備註

指定該 FileOptions.SequentialScan 標誌可以提升使用序列存取讀取大型檔案的應用程式效能。 對於主要依序讀取大型檔案，但偶爾會跳過小範圍位元組的應用程式，效能提升更為明顯。

適用於