共用方式為


LogRecordSequence 建構函式

定義

初始化 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

例外狀況

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 值,可決定如何開啟或建立存放區。

例外狀況

pathnull

path 為空字串 ("")。

-或-

path 僅包含泛空白字元。

-或-

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

mode 包含無效的值。

找不到檔案。

開啟記錄存放區時發生 I/O 錯誤。

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

不支援此作業。

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

因為尚未安裝所需的一般記錄檔系統 (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

需要的緩衝區數量。

例外狀況

logStorenull

bufferSize 為負值或零。

-或-

bufferCount 為負值或零。

備註

如果您想要指定 bufferSizebufferCount 值,而且不想使用 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 如何存取檔案。

例外狀況

pathnull

path 為空字串 ("")。

-或-

path 僅包含泛空白字元。

-或-

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

mode 包含無效的值。

找不到檔案。

開啟記錄存放區時發生 I/O 錯誤。

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

不支援此作業。

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

因為尚未安裝所需的一般記錄檔系統 (CLFS) 元件,所以無法使用 LogRecordSequence。 如果 CLFS 元件適用於您的平台,請進行安裝,或請使用 FileRecordSequence 類別。

備註

這個建構函式 (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 值,可決定在處理序之間共用記錄存放區的方式。

例外狀況

pathnull

path 為空字串 ("")。

-或-

path 僅包含泛空白字元。

-或-

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

mode 包含無效的值。

找不到檔案。

開啟記錄存放區時發生 I/O 錯誤。

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

不支援此作業。

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

因為尚未安裝所需的一般記錄檔系統 (CLFS) 元件,所以無法使用 LogRecordSequence。 如果 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

備註

這個建構函式 (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

需要的緩衝區數量。

例外狀況

pathnull

path 為空字串 ("")。

-或-

path 僅包含泛空白字元。

-或-

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

mode 包含無效的值。

找不到檔案。

開啟記錄存放區時發生 I/O 錯誤。

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

不支援此作業。

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

因為尚未安裝所需的一般記錄檔系統 (CLFS) 元件,所以無法使用 LogRecordSequence。 如果 CLFS 元件適用於您的平台,請進行安裝,或請使用 FileRecordSequence 類別。

備註

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

參數

path
String

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

mode
FileMode

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

access
FileAccess

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

share
FileShare

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

bufferSize
Int32

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

bufferCount
Int32

需要的緩衝區數量。

fileSecurity
FileSecurity

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

例外狀況

path 指定的檔案無效。

-或-

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

-或-

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

-或-

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

一或多個引數為 null

一或多個引數超出範圍。

找不到 path 指定的檔案。

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

-或-

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

-或-

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

-或-

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

-或-

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

不支援此作業。

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

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

因為尚未安裝所需的一般記錄檔系統 (CLFS) 元件,所以無法使用 LogRecordSequence。 如果 CLFS 元件適用於您的平台,請進行安裝,或請使用 FileRecordSequence 類別。

記錄順序已滿。

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

適用於