Microsoft.Win32.Registry

提供用於表示 Windows 登錄中根目錄機碼的物件，以及用於存取機碼/值組的 static 方法。

定義文件的型別 (或類別) 以及與型別相關聯的屬性。這個欄位會讀取 Windows 登錄主要機碼 HKEY_CLASSES_ROOT。

包含非針對特定使用者的硬體相關組態資訊。這個欄位會讀取 Windows 登錄主要機碼 HKEY_CURRENT_CONFIG。

包含有關目前使用者喜好設定的資訊。這個欄位會讀取 Windows 登錄主要機碼 HKEY_CURRENT_USER。

在指定的登錄機碼中，擷取與所指定名稱關聯的值。如果在指定的機碼中找不到該名稱，則會傳回提供的預設值；如果指定的機碼不存在，則傳回 null。

如果指定的子機碼不存在，則為 null，否則為與關聯的值；如果找不到，則為。機碼的完整登錄路徑，以有效登錄根目錄開頭 (例如 "HKEY_CURRENT_USER")。名稱/值組的名稱。不存在時所傳回的值。使用者沒有讀取登錄機碼所需的使用權限。包含指定值的已標記為刪除。不是以有效的登錄根目錄開頭。

包含本機電腦的組態資料。這個欄位會讀取 Windows 登錄主要機碼 HKEY_LOCAL_MACHINE。

包含軟體元件的效能資訊這個欄位會讀取 Windows 登錄主要機碼 HKEY_PERFORMANCE_DATA。

在指定的登錄機碼上設定指定的名稱/值組。如果指定的機碼不存在，則會建立它。

機碼的完整登錄路徑，以有效登錄根目錄開頭 (例如 "HKEY_CURRENT_USER")。名稱/值組的名稱。要儲存的值。為 null。不是以有效的登錄根目錄開頭。-或- 超過所允許的最大長度 (255 個字元)。為唯讀，因此無法寫入 (例如，它是根層次節點)。使用者沒有建立或修改登錄機碼所需的使用權限。

使用指定的登錄資料型別，在指定的登錄機碼上設定名稱/值組。如果指定的機碼不存在，則會建立它。

機碼的完整登錄路徑，以有效登錄根目錄開頭 (例如 "HKEY_CURRENT_USER")。名稱/值組的名稱。要儲存的值。儲存資料時要使用的登錄資料型別。為 null。不是以有效的登錄根目錄開頭。-或- 超過所允許的最大長度 (255 個字元)。-或- 的型別與所指定的登錄資料型別不符，因此，無法正確轉換資料。為唯讀，因此無法寫入 (例如，它是根層次節點，或未以寫入權限來開啟該機碼)。使用者沒有建立或修改登錄機碼所需的使用權限。

包含有關預設使用者組態的資訊。這個欄位會讀取 Windows 登錄主要機碼 HKEY_USERS。

表示外部電腦最上層節點的可能值。

表示其他電腦上的 HKEY_CLASSES_ROOT 機碼。這個值可以傳遞至方法以遠端方式來開啟這個節點。

表示其他電腦上的 HKEY_CURRENT_CONFIG 機碼。這個值可以傳遞至方法以遠端方式來開啟這個節點。

表示其他電腦上的 HKEY_CURRENT_USER 機碼。這個值可以傳遞至方法以遠端方式來開啟這個節點。

表示其他電腦上的 HKEY_LOCAL_MACHINE 機碼。這個值可以傳遞至方法以遠端方式來開啟這個節點。

表示其他電腦上的 HKEY_PERFORMANCE_DATA 機碼。這個值可以傳遞至方法以遠端方式來開啟這個節點。

表示其他電腦上的 HKEY_USERS 機碼。這個值可以傳遞至方法以遠端方式來開啟這個節點。

表示 Windows 登錄中的機碼層級節點。這個類別的作用是登錄封裝。

為寫入權限建立新的子機碼，或開啟現有的子機碼。

傳回新建立的子機碼，或者如果作業失敗，則傳回 null。如果為指定了長度為零的字串，則會傳回目前的物件。要建立或開啟之子機碼的名稱或路徑。這個字串不會區分大小寫。為 null。使用者沒有建立或開啟登錄機碼所需的使用權限。叫用這個方法的已經關閉 (關閉的機碼無法存取)。無法寫入，例如不是開啟為可寫入的機碼，或使用者沒有必要的存取權限。巢狀層次超過 510。-或-發生系統錯誤，例如刪除機碼，或是嘗試在根目錄中建立機碼。

建立新的子機碼，或開啟現有的子機碼指定的存取權。從開始提供.NET Framework 2015

傳回新建立的子機碼，或者如果作業失敗，則傳回 null。如果為指定了長度為零的字串，則會傳回目前的物件。要建立或開啟之子機碼的名稱或路徑。這個字串不會區分大小寫。 true若要指出新的子機碼是可寫入；否則， false。為 null。使用者沒有建立或開啟登錄機碼所需的使用權限。無法寫入目前的，例如不是開啟為可寫入的機碼，或使用者沒有必要的存取權限。巢狀層次超過 510。-或-發生系統錯誤，例如刪除機碼，或是嘗試在根目錄中建立機碼。

建立新的子機碼，或開啟現有的子機碼指定的存取權。從開始提供.NET Framework 2015

傳回新建立的子機碼，或者如果作業失敗，則傳回 null。如果為指定了長度為零的字串，則會傳回目前的物件。要建立或開啟之子機碼的名稱或路徑。這個字串不會區分大小寫。 true若要指出新的子機碼是可寫入；否則， false。要使用的登錄選項。為 null。未指定有效的選項使用者沒有建立或開啟登錄機碼所需的使用權限。無法寫入目前的，例如不是開啟為可寫入的機碼，或使用者沒有必要的存取權限。巢狀層次超過 510。-或-發生系統錯誤，例如刪除機碼，或是嘗試在根目錄中建立機碼。

刪除指定的子機碼。

要刪除的子機碼名稱。這個字串不會區分大小寫。有子系子機碼參數沒有指定有效的登錄機碼是null 使用者沒有刪除機碼所需的使用權限。正接受管理的已經關閉 (關閉的機碼無法存取)。使用者沒有必要的登錄權限。

刪除指定的子機碼，並且指定在找不到該子機碼時是否引發例外狀況。

要刪除的子機碼名稱。這個字串不會區分大小寫。表示如果找不到指定子機碼時，是否引發例外狀況。如果這個引數為 true，而指定的子機碼不存在時，則會引發例外狀況。如果這個引數為 false，而指定的子機碼不存在時，則不採取任何動作。有子系子機碼。沒有指定有效的登錄機碼，而且為 true。為 null。使用者沒有刪除機碼所需的使用權限。正接受管理的已經關閉 (關閉的機碼無法存取)。使用者沒有必要的登錄權限。

遞迴地刪除子機碼和任何子系子機碼。

要刪除的子機碼。這個字串不會區分大小寫。為 null。已嘗試根群組的刪除。-或- 沒有指定有效的登錄子機碼。發生 I/O 錯誤。使用者沒有刪除機碼所需的使用權限。正接受管理的已經關閉 (關閉的機碼無法存取)。使用者沒有必要的登錄權限。

遞迴地刪除指定的子機碼和任何子系子機碼，並且指定在找不到該子機碼時是否引發例外狀況。

要刪除的子機碼名稱。這個字串不會區分大小寫。表示如果找不到指定子機碼時，是否引發例外狀況。如果這個引數為 true，而指定的子機碼不存在時，則會引發例外狀況。如果這個引數為 false，而指定的子機碼不存在時，則不採取任何動作。嘗試刪除樹狀目錄的根登錄區。-或- 沒有指定有效的登錄子機碼，而且為 true。為 null。已經關閉 (關閉的機碼無法存取)。使用者沒有必要的登錄權限。使用者沒有刪除機碼所需的使用權限。

從這個機碼中刪除指定值。

要刪除的值的名稱。不是值的有效參考。使用者沒有刪除值所需的使用權限。正接受管理的已經關閉 (關閉的機碼無法存取)。管理中的是唯讀的。

刪除此機碼的指定值，並且指定找不到該值時是否引發例外狀況。

要刪除的值的名稱。表示如果找不到指定的值時，是否引發例外狀況。如果這個引數為 true，而指定的值不存在時，則會引發例外狀況。如果這個引數為 false，而指定的值不存在時，則不採取任何動作。不是值的有效參考，而且為 true。-或- 為 null。使用者沒有刪除值所需的使用權限。正接受管理的已經關閉 (關閉的機碼無法存取)。管理中的是唯讀的。

將類別目前的執行個體所使用的資源全部釋出。

將指定的開啟登錄機碼的所有屬性 (Attribute) 寫入登錄中。

[安全性關鍵] 從指定的控制代碼建立登錄機碼。

登錄機碼 (Registry Key)。登錄機碼的控制代碼。

[安全性關鍵] 從指定的控制代碼和登錄檢視設定，建立登錄機碼。

登錄機碼 (Registry Key)。登錄機碼的控制代碼。要使用的登錄檢視。

擷取包含所有子機碼名稱的字串陣列。

字串的陣列包含了目前機碼的子機碼名稱。使用者沒有讀取機碼所需的使用權限。正接受管理的已經關閉 (關閉的機碼無法存取)。使用者沒有必要的登錄權限。發生系統錯誤，例如，目前的機碼已經刪除。

擷取與指定名稱關聯的值。如果登錄中沒有名稱/值組，則傳回 null。

與關聯的值，如果找不到，則為 null。要擷取的值的名稱。這個字串不會區分大小寫。使用者沒有讀取登錄機碼所需的使用權限。包含指定值的已經關閉 (關閉的機碼無法存取)。包含指定值的已標記為刪除。使用者沒有必要的登錄權限。

擷取與指定名稱關聯的值。如果找不到名稱，則傳回您提供的預設值。

與關聯的值，擁有未展開的內嵌環境變數，如果找不到，則為。要擷取的值的名稱。這個字串不會區分大小寫。不存在時所傳回的值。使用者沒有讀取登錄機碼所需的使用權限。包含指定值的已經關閉 (關閉的機碼無法存取)。包含指定值的已標記為刪除。使用者沒有必要的登錄權限。

擷取與指定名稱及擷取選項關聯的值。如果找不到名稱，則傳回您提供的預設值。

與關聯的值，根據指定的處理，如果找不到，則為。要擷取的值的名稱。這個字串不會區分大小寫。不存在時所傳回的值。其中一個列舉值，指定擷取之值的選擇性處理。使用者沒有讀取登錄機碼所需的使用權限。包含指定值的已經關閉 (關閉的機碼無法存取)。包含指定值的已標記為刪除。不是有效的值，例如將無效的值轉換成。使用者沒有必要的登錄權限。

擷取與指定名稱關聯之值的登錄資料類型。

與關聯的值的登錄資料型別。要擷取之登錄資料類型的值的名稱。這個字串不會區分大小寫。使用者沒有讀取登錄機碼所需的使用權限。包含指定值的已經關閉 (關閉的機碼無法存取)。包含指定值的子機碼不存在。-或- 指定的名稱/值組不存在。在 Windows 95、Windows 98 或 Windows Millennium Edition 上不會擲回這個例外狀況。使用者沒有必要的登錄權限。

擷取包含所有與這個機碼相關值名稱的字串陣列。

字串的陣列，包含目前機碼的值名稱。使用者沒有讀取登錄機碼所需的使用權限。正接受管理的已經關閉 (關閉的機碼無法存取)。使用者沒有必要的登錄權限。發生系統錯誤，例如，目前的機碼已經刪除。

[安全性關鍵] 取得物件，這個物件表示目前物件所封裝的登錄機碼。

登錄機碼的控制代碼。

擷取機碼名稱。

機碼的絕對 (限定) 名稱。已經關閉 (關閉的機碼無法存取)。

使用指定的檢視，開啟本機電腦上表示要求機碼的新。

要求的登錄機碼。要開啟的 HKEY。要使用的登錄檢視。或無效。使用者沒有必要的登錄權限。使用者沒有執行此動作所需的權限。

擷取子機碼為唯讀。

要求的子機碼，或者在作業失敗時則為 null。以唯讀方式開啟之子機碼的名稱或路徑。是null 已經關閉 (關閉的機碼無法存取)。使用者沒有讀取登錄機碼所需的使用權限。

擷取指定的子機碼，並且指定此機碼是否要套用寫入存取權限。

要求的子機碼，或者在作業失敗時則為 null。要開啟的子機碼名稱或路徑。如果需要機碼的寫入權限，請設定為 true。為 null。已經關閉 (關閉的機碼無法存取)。使用者沒有以指定模式存取登錄機碼所需的使用權限。

擷取具有指定名稱和的子機碼。從開始提供.NET Framework 2015

要求的子機碼，或者在作業失敗時則為 null。要建立或開啟之子機碼的名稱或路徑。登錄機碼的權限。為 null。已經關閉 (關閉的機碼無法存取)。使用者沒有以指定模式存取登錄機碼所需的使用權限。

設定指定的名稱/值組。

要儲存的值的名稱。要儲存的資料。為 null。是不支援的資料型別。包含指定值的已經關閉 (關閉的機碼無法存取)。是唯讀的，無法被寫入，例如沒有以寫入權限開啟機碼。-或- 物件表示根層級節點，且作業系統是 Windows Millennium Edition 或 Windows 98。使用者沒有建立或修改登錄機碼所需的使用權限。物件表示根層級節點，且作業系統是 Windows 2000、Windows XP 或 Windows Server 2003。

使用指定的登錄資料類型，設定登錄機碼中名稱/值組的值。

要儲存之值的名稱。要儲存的資料。儲存資料時要使用的登錄資料類型。為 null。的型別與所指定的登錄資料型別不符，因此，無法正確轉換資料。包含指定值的已經關閉 (關閉的機碼無法存取)。是唯讀的，無法被寫入，例如沒有以寫入權限開啟機碼。-或- 物件表示根層級節點，且作業系統是 Windows Millennium Edition 或 Windows 98。使用者沒有建立或修改登錄機碼所需的使用權限。物件表示根層級節點，且作業系統是 Windows 2000、Windows XP 或 Windows Server 2003。

擷取目前機碼中子機碼的計數。

目前機碼的子機碼數目。使用者不具有機碼的讀取權限。正接受管理的已經關閉 (關閉的機碼無法存取)。使用者沒有必要的登錄權限。發生系統錯誤，例如，目前的機碼已經刪除。

擷取這個機碼的字串表示。

表示機碼的字串。如果指定的機碼是無效的 (找不到)，則會傳回 null 值。正接受存取的已經關閉 (關閉的機碼無法存取)。

擷取機碼中值的計數。

機碼中的名稱/值組的數目。使用者不具有機碼的讀取權限。正接受管理的已經關閉 (關閉的機碼無法存取)。使用者沒有必要的登錄權限。發生系統錯誤，例如，目前的機碼已經刪除。

取得用來建立登錄機碼的檢視。

用來建立登錄機碼的檢視。-或-如果未使用檢視，則為。

指定建立登錄機碼時要使用的選項。

非 Volatile 機碼。這是預設值。

Volatile 機碼。在記憶體中儲存資訊，而且當對應的登錄區卸載時不會保留資訊。

設定將資料值放到登錄內時所使用的資料型別，或代表登錄資料庫內資料值的型別。

任何形式的二進位資料，等於 Win32 API 中的 REG_BINARY 登錄資料型別。

32 位元二進位數字，等於 Win32 API 中的 REG_DWORD 登錄資料型別。

以 null 結尾的字串，其中包含未展開的環境變數參考，例如 %PATH%，以後要擷取值時，環境變數就會展開。這個值等於 Win32 API 中的 REG_EXPAND_SZ 登錄資料型別。

以 null 結尾的字串所組成的陣列，整個陣列最後以兩個 null 字元做為結尾。這個值等於 Win32 API 中的 REG_MULTI_SZ 登錄資料型別。

無資料型別。

64 位元二進位數字，等於 Win32 API 中的 REG_QWORD 登錄資料型別。

以 null 結尾的字串，等於 Win32 API 中的 REG_SZ 登錄資料型別。

不支援的登錄資料型別，例如，Microsoft Win32 API 的 REG_RESOURCE_LIST 登錄資料型別就是其中之一。您可以使用這個值指定方法在儲存名稱/值組時，應該自行決定適當的登錄資料型別。

在擷取登錄機碼的名稱/值組時，指定選擇項行為。

型別的值，能夠在沒有展開其內嵌環境變數的情況下擷取。

沒有指定的選擇項行為。

指定在 64 位元作業系統上以哪個登錄檢視為目標。

預設檢視。

32 位元檢視。

64 位元檢視。

[安全性關鍵] 表示 Windows 登錄的安全控制代碼。

[安全性關鍵] 初始化類別的新執行個體。

物件，表示要使用的既有控制代碼。 true 表示在結束階段確實地釋放控制代碼，false 表示不要確實地釋放。

指定可套用至登錄物件的存取控制 (Access Control) 權限。

變更與登錄機碼相關聯之存取規則和稽核規則的權限。

保留供系統使用。

建立登錄機碼之子機碼的權限。

刪除登錄機碼的權限。

列出登錄機碼之子機碼的權限。

與相同。

對登錄機碼執行完全控制以及修改其存取規則和稽核規則的權限。

要求通知登錄機碼變更的權限。

查詢登錄機碼中名稱/值組的權限。

查詢登錄機碼中名稱/值組、要求通知變更、列舉其子機碼，以及讀取其存取規則和稽核規則的權限。

開啟並複製登錄機碼之存取規則和稽核規則的權限。

建立、刪除或設定登錄機碼中名稱/值組的權限。

變更登錄機碼擁有人的權限。

建立、刪除、設定登錄機碼中名稱/值組、建立或刪除子機碼、要求通知變更、列舉其子機碼，以及讀取其存取規則和稽核規則的權限。