LogStore 建構函式
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
初始化 LogStore 類別的新執行個體。
多載
| 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。
記錄檔控制代碼無法繫結至執行緒集區。
存取指定的記錄存放區遭作業系統拒絕。
已在處置序列之後呼叫此方法。
沒有足夠的記憶體可以繼續執行程式。
適用於
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 錯誤。
存取指定的記錄存放區遭作業系統拒絕。
因為尚未安裝所需的一般記錄檔系統 (CLFS) 元件，所以無法使用 LogStore。 如果 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 錯誤。
存取指定的記錄存放區遭作業系統拒絕。
因為尚未安裝所需的一般記錄檔系統 (CLFS) 元件，所以無法使用 LogStore。 如果 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 錯誤。
存取指定的記錄存放區遭作業系統拒絕。
因為尚未安裝所需的一般記錄檔系統 (CLFS) 元件，所以無法使用 LogStore。 如果 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 所指定的檔案。
-或-
記錄檔控制代碼無法繫結至執行緒集區。
-或-
指定的記錄檔格式或版本無效。
因為尚未安裝所需的一般記錄檔系統 (CLFS) 元件，所以無法使用 LogStore。 如果 CLFS 元件適用於您的平台，請加以安裝或改用 FileRecordSequence 類別。
已在處置序列之後呼叫此方法。
沒有足夠的記憶體可以繼續執行程式。
記錄順序已滿。
存取指定的記錄存放區遭作業系統拒絕。
備註
這個建構函式會初始化新的 LogStore 物件，而這個物件是以指定的路徑、模式和存取權限所開啟的。 存放區會開啟，並且共用指定的存取權限。 path 參數應遵循下列語法：
log:<physical log name>[::<log client name>]
其中 <physical log name> 是記錄檔的有效路徑，而 <log client name> 則是唯一的用戶端識別項。 記錄存放區必須是實體記錄存放區或虛擬記錄存放區，但不會同時為這兩者。 一旦建立實體或虛擬記錄存放區，其狀態就會永久保持不變。 實體記錄存放區的建立方式是單獨指定實體記錄名稱。 虛擬記錄存放區的建立方式是同時指定實體記錄名稱和記錄用戶端名稱。
實體記錄名稱相同的用戶端，其延伸區集合和原則也會相同。
適用於
意見反應
即將登場：在 2024 年，我們將逐步淘汰 GitHub 問題作為內容的意見反應機制，並將它取代為新的意見反應系統。 如需詳細資訊，請參閱：https://aka.ms/ContentUserFeedback。
提交並檢視相關的意見反應