LogStore 建構函式
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
初始化 LogStore 類別的新執行個體。
多載
| 名稱 | Description |
|---|---|
| LogStore(SafeFileHandle) |
初始化指定代言柄的類別新實例 LogStore 。 |
| LogStore(String, FileMode) |
初始化一個以指定路徑與模式的新類別實例 LogStore 。 |
| LogStore(String, FileMode, FileAccess) |
初始化類別的新實例 LogStore ，並以指定的路徑、模式與存取方式初始化。 |
| LogStore(String, FileMode, FileAccess, FileShare) |
初始化 LogStore 類別的新執行個體。 |
| LogStore(String, FileMode, FileAccess, FileShare, FileSecurity) |
初始化 LogStore 類別的新執行個體。 |
LogStore(SafeFileHandle)
初始化指定代言柄的類別新實例 LogStore 。
public:
LogStore(Microsoft::Win32::SafeHandles::SafeFileHandle ^ handle);public LogStore(Microsoft.Win32.SafeHandles.SafeFileHandle handle);new System.IO.Log.LogStore : Microsoft.Win32.SafeHandles.SafeFileHandle -> System.IO.Log.LogStorePublic Sub New (handle As SafeFileHandle)參數
- handle
- SafeFileHandle
一個用於當前物件封裝的日誌檔案 LogStore 的檔案柄。
例外狀況
handle 是 null。
日誌 handle 無法綁定到執行緒池。
作業系統會拒絕存取指定的日誌儲存。
該方法是在序列被處理後才被呼叫的。
記憶體不足以繼續執行程式。
適用於
LogStore(String, FileMode)
初始化一個以指定路徑與模式的新類別實例 LogStore 。
public:
LogStore(System::String ^ path, System::IO::FileMode mode);public LogStore(string path, System.IO.FileMode mode);new System.IO.Log.LogStore : string * System.IO.FileMode -> System.IO.Log.LogStorePublic Sub New (path As String, mode As FileMode)參數
- path
- String
日誌儲存庫基礎檔案開啟的相對或絕對路徑。
例外狀況
path 是 null。
mode 包含無效值。
找不到該檔案。
開啟日誌儲存時會發生 I/O 錯誤。
作業系統會拒絕存取指定的日誌儲存。
LogStore 無法使用，因為未安裝所需的通用日誌檔案系統（CLFS）元件。 如果你的平台有 CLFS 元件，請安裝，或者改用 CLFS FileRecordSequence 元件。
記憶體不足以繼續執行程式。
備註
使用此建構子開啟包含指定路徑與模式的日誌儲存。 儲存裝置開啟時有讀寫權限，並共享讀取權限。
path參數應使用以下語法：
log:<physical log name>[::<log client name>]
其中 <physical log name> 是通往日誌檔案的有效路徑， 是 <log client name> 唯一用戶端識別碼。 日誌儲存應該是實體日誌儲存或虛擬登錄儲存，但不能兩者兼有。 一旦實體或虛擬建立起原木倉庫，其存續期間即為此。 實體日誌儲存是透過僅指定實體日誌名稱來建立的。 虛擬日誌儲存是透過指定實體日誌名稱與日誌用戶端名稱來建立的。
共用相同實體日誌名稱的客戶端會共享相同的範圍收集和政策。
適用於
LogStore(String, FileMode, FileAccess)
初始化類別的新實例 LogStore ，並以指定的路徑、模式與存取方式初始化。
public:
LogStore(System::String ^ path, System::IO::FileMode mode, System::IO::FileAccess access);public LogStore(string path, System.IO.FileMode mode, System.IO.FileAccess access);new System.IO.Log.LogStore : string * System.IO.FileMode * System.IO.FileAccess -> System.IO.Log.LogStorePublic Sub New (path As String, mode As FileMode, access As FileAccess)參數
- path
- String
日誌儲存庫基礎檔案開啟的相對或絕對路徑。
- access
- FileAccess
FileAccess決定檔案如何被存取LogStore的值之一。
例外狀況
path 是 null。
找不到該檔案。
開啟日誌儲存時會發生 I/O 錯誤。
作業系統會拒絕存取指定的日誌儲存。
LogStore 無法使用，因為未安裝所需的通用日誌檔案系統（CLFS）元件。 如果你的平台有 CLFS 元件，請安裝，或者改用 CLFS FileRecordSequence 元件。
記憶體不足以繼續執行程式。
備註
使用此建構子開啟一個新的日誌儲存，包含指定的路徑、模式與存取權限。 該商店是開放的，共享閱讀權限。
path參數應使用以下語法：
log:<physical log name>[::<log client name>]
其中 <physical log name> 是通往日誌檔案的有效路徑， 是 <log client name> 唯一用戶端識別碼。 日誌儲存應該是實體日誌儲存或虛擬登錄儲存，但不能兩者兼有。 一旦實體或虛擬建立起原木倉庫，其存續期間即為此。 實體日誌儲存是透過僅指定實體日誌名稱來建立的。 虛擬日誌儲存是透過指定實體日誌名稱與日誌用戶端名稱來建立的。
共用相同實體日誌名稱的客戶端會共享相同的範圍收集和政策。
適用於
LogStore(String, FileMode, FileAccess, FileShare)
初始化 LogStore 類別的新執行個體。
public:
LogStore(System::String ^ path, System::IO::FileMode mode, System::IO::FileAccess access, System::IO::FileShare share);public LogStore(string path, System.IO.FileMode mode, System.IO.FileAccess access, System.IO.FileShare share);new System.IO.Log.LogStore : string * System.IO.FileMode * System.IO.FileAccess * System.IO.FileShare -> System.IO.Log.LogStorePublic Sub New (path As String, mode As FileMode, access As FileAccess, share As FileShare)參數
- path
- String
日誌儲存庫基礎檔案開啟的相對或絕對路徑。
- access
- FileAccess
FileAccess決定檔案如何被存取LogStore的值之一。
例外狀況
path 是 null。
找不到該檔案。
開啟日誌儲存時會發生 I/O 錯誤。
作業系統會拒絕存取指定的日誌儲存。
LogStore 無法使用，因為未安裝所需的通用日誌檔案系統（CLFS）元件。 如果你的平台有 CLFS 元件，請安裝，或者改用 CLFS FileRecordSequence 元件。
記憶體不足以繼續執行程式。
備註
此建構子初始化一個新 LogStore 物件，並以指定的路徑、模式與存取方式開啟。 儲存會被開啟，共享指定的存取權限。
path參數應使用以下語法：
log:<physical log name>[::<log client name>]
其中 <physical log name> 是通往日誌檔案的有效路徑， 是 <log client name> 唯一用戶端識別碼。 日誌儲存應該是實體日誌儲存或虛擬登錄儲存，但不能兩者兼有。 一旦實體或虛擬建立起原木倉庫，其存續期間即為此。 實體日誌儲存是透過僅指定實體日誌名稱來建立的。 虛擬日誌儲存是透過指定實體日誌名稱與日誌用戶端名稱來建立的。
共用相同實體日誌名稱的客戶端會共享相同的範圍收集和政策。
適用於
LogStore(String, FileMode, FileAccess, FileShare, FileSecurity)
初始化 LogStore 類別的新執行個體。
public:
LogStore(System::String ^ path, System::IO::FileMode mode, System::IO::FileAccess access, System::IO::FileShare share, System::Security::AccessControl::FileSecurity ^ fileSecurity);public LogStore(string path, System.IO.FileMode mode, System.IO.FileAccess access, System.IO.FileShare share, System.Security.AccessControl.FileSecurity fileSecurity);new System.IO.Log.LogStore : string * System.IO.FileMode * System.IO.FileAccess * System.IO.FileShare * System.Security.AccessControl.FileSecurity -> System.IO.Log.LogStorePublic Sub New (path As String, mode As FileMode, access As FileAccess, share As FileShare, fileSecurity As FileSecurity)參數
- path
- String
日誌儲存庫基礎檔案開啟的相對或絕對路徑。
- access
- FileAccess
FileAccess決定檔案如何被存取LogStore的值之一。
- fileSecurity
- FileSecurity
FileSecurity其中一個值指定了如果必須建立新建立的儲存裝置，該儲存裝置應該設定的安全措施。
例外狀況
path 是 null。
所 path 指定的日誌儲存檔名稱不有效。
-或-
mode 是 CreateNew，且在沒有寫入權限的情況下無法使用。
-或-
mode 是 OpenOrCreate，且在沒有寫入權限的情況下無法使用。
找不到該檔案。
開啟日誌儲存時會發生 I/O 錯誤。
由 path 指定的檔案無法存取，因為它正被其他程序使用。
-或-
由指定的 path 檔案無法被建立，因為該檔案或目錄已經存在。
-或-
日誌 handle 無法綁定到執行緒池。
-或-
指定的日誌檔案格式或版本無效。
LogStore 無法使用，因為未安裝所需的通用日誌檔案系統（CLFS）元件。 如果你的平台有 CLFS 元件，請安裝，或者改用 CLFS FileRecordSequence 元件。
該方法是在序列被處理後才被呼叫的。
記憶體不足以繼續執行程式。
紀錄序列已滿。
作業系統會拒絕存取指定的日誌儲存。
備註
此建構子初始化一個新 LogStore 物件，並以指定的路徑、模式與存取方式開啟。 儲存會被開啟，共享指定的存取權限。
path參數應遵循以下語法：
log:<physical log name>[::<log client name>]
其中 <physical log name> 是通往日誌檔案的有效路徑， 是 <log client name> 唯一用戶端識別碼。 日誌儲存應該是實體日誌儲存或虛擬登錄儲存，但不能兩者兼有。 一旦實體或虛擬建立起原木倉庫，其存續期間即為此。 實體日誌儲存是透過僅指定實體日誌名稱來建立的。 虛擬日誌儲存是透過指定實體日誌名稱與日誌用戶端名稱來建立的。
共用相同實體日誌名稱的客戶端會共享相同的範圍收集和政策。
