LogRecordSequence 建構函式

定義

命名空間:: System.IO.Log

組件:: System.IO.Log.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

初始化 LogRecordSequence 類別的新執行個體。

多載

名稱	Description
LogRecordSequence(LogStore)	初始化一個新的類別實例 LogRecordSequence ，使用指定的日誌儲存。
LogRecordSequence(String, FileMode)	初始化一個新的類別實例 LogRecordSequence ，並設定指定路徑至日誌儲存庫及存取模式。
LogRecordSequence(LogStore, Int32, Int32)	初始化一個新的類別實例 LogRecordSequence ，包含指定的日誌儲存、每個記錄的緩衝區大小及緩衝區號碼。
LogRecordSequence(String, FileMode, FileAccess)	初始化類別的新實例 LogRecordSequence ，並設定指定路徑至日誌儲存及存取與分享模式。
LogRecordSequence(String, FileMode, FileAccess, FileShare)	初始化一個新的類別實例 LogRecordSequence ，並設定指定路徑至日誌儲存庫及存取模式。
LogRecordSequence(String, FileMode, FileAccess, FileShare, Int32, Int32)	初始化類別的新實例 LogRecordSequence ，並設定指定路徑至日誌儲存、檔案權限、存取與分享模式，以及緩衝區大小與記錄計數。
LogRecordSequence(String, FileMode, FileAccess, FileShare, Int32, Int32, FileSecurity)	初始化 LogRecordSequence 類別的新執行個體。

LogRecordSequence(LogStore)

初始化一個新的類別實例 LogRecordSequence ，使用指定的日誌儲存。

public:
 LogRecordSequence(System::IO::Log::LogStore ^ logStore);

public LogRecordSequence(System.IO.Log.LogStore logStore);

new System.IO.Log.LogRecordSequence : System.IO.Log.LogStore -> System.IO.Log.LogRecordSequence

Public Sub New (logStore As LogStore)

參數

logStore: LogStore

這個 LogStore 紀錄序列應該使用。

例外狀況

ArgumentException

logStore 無效。

備註

緩衝區大小決定可附加或讀取記錄的最大大小。在此構造子中，預設值為 64。預備區的期望數量設為 10。

適用於

LogRecordSequence(String, FileMode)

初始化一個新的類別實例 LogRecordSequence ，並設定指定路徑至日誌儲存庫及存取模式。

public:
 LogRecordSequence(System::String ^ path, System::IO::FileMode mode);

public LogRecordSequence(string path, System.IO.FileMode mode);

new System.IO.Log.LogRecordSequence : string * System.IO.FileMode -> System.IO.Log.LogRecordSequence

Public Sub New (path As String, mode As FileMode)

參數

path: String

日誌儲存庫基礎檔案開啟的相對或絕對路徑。

mode: FileMode

FileMode這是決定如何開店或建立店面的價值觀之一。

例外狀況

ArgumentNullException

path 是 null。

ArgumentException

path 是空字串（“”）。

-或-

path 僅包含空白區域。

-或-

path 包含一個或多個無效字元。

ArgumentOutOfRangeException

mode 包含無效值。

FileNotFoundException

找不到該檔案。

IOException

開啟日誌儲存時會發生 I/O 錯誤。

UnauthorizedAccessException

作業系統會拒絕存取指定的日誌序列。

NotSupportedException

此操作未被支援。

OutOfMemoryException

記憶體不足以繼續執行程式。

PlatformNotSupportedException

LogRecordSequence 無法使用，因為未安裝所需的通用日誌檔案系統（CLFS）元件。如果你平台有 CLFS 元件，請安裝，或使用該 FileRecordSequence 類別。

備註

此建構子會對LogRecordSequence新物件初始化一個LogStore新物件，並以指定的路徑與模式開啟該物件。它獲得對儲存庫的讀寫權限，且儲存空間會被開啟，共享讀取權限。

適用於

LogRecordSequence(LogStore, Int32, Int32)

初始化一個新的類別實例 LogRecordSequence ，包含指定的日誌儲存、每個記錄的緩衝區大小及緩衝區號碼。

public:
 LogRecordSequence(System::IO::Log::LogStore ^ logStore, int bufferSize, int bufferCount);

public LogRecordSequence(System.IO.Log.LogStore logStore, int bufferSize, int bufferCount);

new System.IO.Log.LogRecordSequence : System.IO.Log.LogStore * int * int -> System.IO.Log.LogRecordSequence

Public Sub New (logStore As LogStore, bufferSize As Integer, bufferCount As Integer)

參數

logStore: LogStore

這個 LogStore 紀錄序列應該使用。

bufferSize: Int32

需要的緩衝區大小 (以位元組為單位)。緩衝區大小決定可附加或讀取記錄的最大大小。

bufferCount: Int32

預備區數量。

例外狀況

ArgumentNullException

logStore 是 null。

ArgumentOutOfRangeException

bufferSize 為負數或零。

-或-

bufferCount 為負數或零。

備註

如果你想指定和 bufferSize 的值bufferCount，且不想用預設值 64 和 bufferSize 10 來bufferCount指定。

適用於

LogRecordSequence(String, FileMode, FileAccess)

初始化類別的新實例 LogRecordSequence ，並設定指定路徑至日誌儲存及存取與分享模式。

public:
 LogRecordSequence(System::String ^ path, System::IO::FileMode mode, System::IO::FileAccess access);

public LogRecordSequence(string path, System.IO.FileMode mode, System.IO.FileAccess access);

new System.IO.Log.LogRecordSequence : string * System.IO.FileMode * System.IO.FileAccess -> System.IO.Log.LogRecordSequence

Public Sub New (path As String, mode As FileMode, access As FileAccess)

參數

path: String

日誌儲存庫基礎檔案開啟的相對或絕對路徑。

mode: FileMode

FileMode這是決定如何開店或建立店面的價值觀之一。

access: FileAccess

FileAccess決定檔案如何被存取LogStore的值之一。

例外狀況

ArgumentNullException

path 是 null。

ArgumentException

path 是空字串（“”）。

-或-

path 僅包含空白區域。

-或-

path 包含一個或多個無效字元。

ArgumentOutOfRangeException

mode 包含無效值。

FileNotFoundException

找不到該檔案。

IOException

開啟日誌儲存時會發生 I/O 錯誤。

UnauthorizedAccessException

作業系統會拒絕存取指定的日誌序列。

NotSupportedException

此操作未被支援。

OutOfMemoryException

記憶體不足以繼續執行程式。

PlatformNotSupportedException

LogRecordSequence 無法使用，因為未安裝所需的通用日誌檔案系統（CLFS）元件。如果你平台有 CLFS 元件，請安裝，或使用該 FileRecordSequence 類別。

備註

此建構子會對一個新LogRecordSequence物件初始化一個LogStore新物件，並以指定的路徑、模式和存取方式開啟。商店開放時共享閱讀權限。

適用於

LogRecordSequence(String, FileMode, FileAccess, FileShare)

初始化一個新的類別實例 LogRecordSequence ，並設定指定路徑至日誌儲存庫及存取模式。

public:
 LogRecordSequence(System::String ^ path, System::IO::FileMode mode, System::IO::FileAccess access, System::IO::FileShare share);

public LogRecordSequence(string path, System.IO.FileMode mode, System.IO.FileAccess access, System.IO.FileShare share);

new System.IO.Log.LogRecordSequence : string * System.IO.FileMode * System.IO.FileAccess * System.IO.FileShare -> System.IO.Log.LogRecordSequence

Public Sub New (path As String, mode As FileMode, access As FileAccess, share As FileShare)

參數

path: String

日誌儲存庫基礎檔案開啟的相對或絕對路徑。

mode: FileMode

FileMode這是決定如何開店或建立店面的價值觀之一。

access: FileAccess

FileAccess決定檔案如何被存取LogStore的值之一。

share: FileShare

這是 FileShare 決定日誌儲存如何在各程序間共享的數值之一。

例外狀況

ArgumentNullException

path 是 null。

ArgumentException

path 是空字串（“”）。

-或-

path 僅包含空白區域。

-或-

path 包含一個或多個無效字元。

ArgumentOutOfRangeException

mode 包含無效值。

FileNotFoundException

找不到該檔案。

IOException

開啟日誌儲存時會發生 I/O 錯誤。

UnauthorizedAccessException

作業系統會拒絕存取指定的日誌序列。

NotSupportedException

此操作未被支援。

OutOfMemoryException

記憶體不足以繼續執行程式。

PlatformNotSupportedException

LogRecordSequence 無法使用，因為未安裝所需的通用日誌檔案系統（CLFS）元件。如果你平台有 CLFS 元件，請安裝，或使用該 FileRecordSequence 類別。

範例

此範例展示了如何使用此 LogRecordSequence 構造子：

// Create a LogRecordSequence.
sequence = new LogRecordSequence(this.logName,
                                  FileMode.CreateNew,
                                  FileAccess.ReadWrite,
                                  FileShare.None);

// At least one container/extent must be added for Log Record Sequence.
sequence.LogStore.Extents.Add(this.logContainer, this.containerSize);

MySequence = sequence;

' Create a LogRecordSequence.
sequence = New LogRecordSequence(Me.logName, FileMode.CreateNew, FileAccess.ReadWrite, FileShare.None)

' At least one container/extent must be added for Log Record Sequence.
sequence.LogStore.Extents.Add(Me.logContainer, Me.containerSize)

MySequence = sequence

備註

此建構子會對一個新LogRecordSequence物件初始化一個LogStore新物件，並以指定的路徑、模式和存取方式開啟。儲存會被開啟，共享指定的存取權限。

適用於

LogRecordSequence(String, FileMode, FileAccess, FileShare, Int32, Int32)

初始化類別的新實例 LogRecordSequence ，並設定指定路徑至日誌儲存、檔案權限、存取與分享模式，以及緩衝區大小與記錄計數。

public:
 LogRecordSequence(System::String ^ path, System::IO::FileMode mode, System::IO::FileAccess access, System::IO::FileShare share, int bufferSize, int bufferCount);

public LogRecordSequence(string path, System.IO.FileMode mode, System.IO.FileAccess access, System.IO.FileShare share, int bufferSize, int bufferCount);

new System.IO.Log.LogRecordSequence : string * System.IO.FileMode * System.IO.FileAccess * System.IO.FileShare * int * int -> System.IO.Log.LogRecordSequence

Public Sub New (path As String, mode As FileMode, access As FileAccess, share As FileShare, bufferSize As Integer, bufferCount As Integer)

參數

path: String

日誌儲存庫基礎檔案開啟的相對或絕對路徑。

mode: FileMode

FileMode這是決定如何開店或建立店面的價值觀之一。

access: FileAccess

FileAccess決定檔案如何被存取LogStore的值之一。

share: FileShare

這是 FileShare 決定日誌儲存如何在各程序間共享的數值之一。

bufferSize: Int32

需要的緩衝區大小 (以位元組為單位)。緩衝區大小決定可附加或讀取記錄的最大大小。

bufferCount: Int32

預備區數量。

例外狀況

ArgumentNullException

path 是 null。

ArgumentException

path 是空字串（“”）。

-或-

path 僅包含空白區域。

-或-

path 包含一個或多個無效字元。

ArgumentOutOfRangeException

mode 包含無效值。

FileNotFoundException

找不到該檔案。

IOException

開啟日誌儲存時會發生 I/O 錯誤。

UnauthorizedAccessException

作業系統會拒絕存取指定的日誌序列。

NotSupportedException

此操作未被支援。

OutOfMemoryException

記憶體不足以繼續執行程式。

PlatformNotSupportedException

LogRecordSequence 無法使用，因為未安裝所需的通用日誌檔案系統（CLFS）元件。如果你平台有 CLFS 元件，請安裝，或使用該 FileRecordSequence 類別。

備註

此建構子會對一個新LogRecordSequence物件初始化一個LogStore新物件，並以指定的路徑、模式和存取方式開啟。儲存會被開啟，共享指定的存取權限。

適用於

LogRecordSequence(String, FileMode, FileAccess, FileShare, Int32, Int32, FileSecurity)

初始化 LogRecordSequence 類別的新執行個體。

public:
 LogRecordSequence(System::String ^ path, System::IO::FileMode mode, System::IO::FileAccess access, System::IO::FileShare share, int bufferSize, int bufferCount, System::Security::AccessControl::FileSecurity ^ fileSecurity);

public LogRecordSequence(string path, System.IO.FileMode mode, System.IO.FileAccess access, System.IO.FileShare share, int bufferSize, int bufferCount, System.Security.AccessControl.FileSecurity fileSecurity);

new System.IO.Log.LogRecordSequence : string * System.IO.FileMode * System.IO.FileAccess * System.IO.FileShare * int * int * System.Security.AccessControl.FileSecurity -> System.IO.Log.LogRecordSequence

Public Sub New (path As String, mode As FileMode, access As FileAccess, share As FileShare, bufferSize As Integer, bufferCount As Integer, fileSecurity As FileSecurity)