LogRecordSequence 建構函式

參考

定義

命名空間:: System.IO.Log

組件:: System.IO.Log.dll

重要

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

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

多載

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

因為尚未安裝所需的一般記錄檔系統 (CLFS) 元件，所以無法使用 LogRecordSequence。如果 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 值，而且不想使用 bufferSize 的預設值 64 和 bufferCount 的預設值 10，可以使用這個建構函式。

適用於

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

備註

這個建構函式 (Constructor) 會在新的 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 建構函式：

// 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

備註

這個建構函式 (Constructor) 會在新的 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(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)

參數

path: String

要開啟之記錄存放區基底檔案的相對或絕對路徑。

mode: FileMode

有效的 FileMode 值，其決定如何開啟或建立存放區。

access: FileAccess

有效的 FileAccess 值，決定如何存取記錄存放區。

share: FileShare

有效的 FileShare 值，可決定在處理序之間共用記錄存放區的方式。

bufferSize: Int32

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

bufferCount: Int32

需要的緩衝區數量。

fileSecurity: FileSecurity

有效的 FileSecurity 值，可指定要針對新建立的存放區設定的安全性 (如果必須建立存放區的話)。

例外狀況

ArgumentException

path 指定的檔案無效。

-或-

指定的記錄存放區檔案名稱無效。

-或-

mode 具有 CreateNew 的值，而且無法在沒有寫入權限的情況下使用。

-或-

mode 具有 OpenOrCreate 的值，而且無法在沒有寫入權限的情況下使用。

ArgumentNullException

一或多個引數為 null。

ArgumentOutOfRangeException

一或多個引數超出範圍。

FileNotFoundException

找不到 path 指定的檔案。

IOException

由於意外的 I/O 例外狀況，所以無法執行要求。

-或-

因為另一個處理序正在使用 path 所指定的檔案，所以無法存取該檔案。

-或-

因為檔案或目錄已存在，所以無法建立 path 所指定的檔案。

-或-

記錄檔控制代碼無法繫結至執行緒集區。

-或-

指定的記錄檔格式或版本無效。

NotSupportedException

不支援此作業。

ObjectDisposedException

已在處置序列之後呼叫此方法。

OutOfMemoryException

沒有足夠的記憶體可以繼續執行程式。

PlatformNotSupportedException

SequenceFullException

記錄順序已滿。

UnauthorizedAccessException

存取指定的記錄順序遭作業系統拒絕。

適用於

共用方式為

LogRecordSequence 建構函式

定義

多載

LogRecordSequence(LogStore)

參數

例外狀況

備註

適用於

LogRecordSequence(String, FileMode)

參數

例外狀況

備註

適用於

LogRecordSequence(LogStore, Int32, Int32)

參數

例外狀況

備註

適用於

LogRecordSequence(String, FileMode, FileAccess)

參數

例外狀況

備註

適用於

LogRecordSequence(String, FileMode, FileAccess, FileShare)

參數

例外狀況

範例

備註

適用於

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

參數

例外狀況

備註

適用於

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

參數

例外狀況

適用於

其他資源