RegistryKey 類別
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
表示 Windows 登錄中的機碼層級節點。 這個類別的作用是登錄封裝。
public ref class RegistryKey sealed : MarshalByRefObject, IDisposablepublic ref class RegistryKey sealed : IDisposablepublic sealed class RegistryKey : MarshalByRefObject, IDisposablepublic sealed class RegistryKey : IDisposable[System.Runtime.InteropServices.ComVisible(true)]
public sealed class RegistryKey : MarshalByRefObject, IDisposabletype RegistryKey = class
inherit MarshalByRefObject
interface IDisposabletype RegistryKey = class
interface IDisposable[<System.Runtime.InteropServices.ComVisible(true)>]
type RegistryKey = class
inherit MarshalByRefObject
interface IDisposablePublic NotInheritable Class RegistryKey
Inherits MarshalByRefObject
Implements IDisposablePublic NotInheritable Class RegistryKey
Implements IDisposable- 繼承
- 繼承
-
RegistryKey
- 屬性
- 實作
範例
下列程式代碼範例示範如何在HKEY_CURRENT_USER下建立子機碼、操作其內容，然後刪除子機碼。
using namespace System;
using namespace System::Security::Permissions;
using namespace Microsoft::Win32;
int main()
{
// Create a subkey named Test9999 under HKEY_CURRENT_USER.
RegistryKey ^ test9999 = Registry::CurrentUser->CreateSubKey( "Test9999" );
// Create two subkeys under HKEY_CURRENT_USER\Test9999.
test9999->CreateSubKey( "TestName" )->Close();
RegistryKey ^ testSettings = test9999->CreateSubKey( "TestSettings" );
// Create data for the TestSettings subkey.
testSettings->SetValue( "Language", "French" );
testSettings->SetValue( "Level", "Intermediate" );
testSettings->SetValue( "ID", 123 );
testSettings->Close();
// Print the information from the Test9999 subkey.
Console::WriteLine( "There are {0} subkeys under Test9999.", test9999->SubKeyCount.ToString() );
array<String^>^subKeyNames = test9999->GetSubKeyNames();
for ( int i = 0; i < subKeyNames->Length; i++ )
{
RegistryKey ^ tempKey = test9999->OpenSubKey( subKeyNames[ i ] );
Console::WriteLine( "\nThere are {0} values for {1}.", tempKey->ValueCount.ToString(), tempKey->Name );
array<String^>^valueNames = tempKey->GetValueNames();
for ( int j = 0; j < valueNames->Length; j++ )
{
Console::WriteLine( "{0,-8}: {1}", valueNames[ j ], tempKey->GetValue( valueNames[ j ] )->ToString() );
}
}
// Delete the ID value.
testSettings = test9999->OpenSubKey( "TestSettings", true );
testSettings->DeleteValue( "id" );
// Verify the deletion.
Console::WriteLine( dynamic_cast<String^>(testSettings->GetValue( "id", "ID not found." )) );
testSettings->Close();
// Delete or close the new subkey.
Console::Write( "\nDelete newly created registry key? (Y/N) " );
if ( Char::ToUpper( Convert::ToChar( Console::Read() ) ) == 'Y' )
{
Registry::CurrentUser->DeleteSubKeyTree( "Test9999" );
Console::WriteLine( "\nRegistry key {0} deleted.", test9999->Name );
}
else
{
Console::WriteLine( "\nRegistry key {0} closed.", test9999->ToString() );
test9999->Close();
}
}
using System;
using System.Security.Permissions;
using Microsoft.Win32;
class RegKey
{
static void Main()
{
// Create a subkey named Test9999 under HKEY_CURRENT_USER.
RegistryKey test9999 =
Registry.CurrentUser.CreateSubKey("Test9999");
// Create two subkeys under HKEY_CURRENT_USER\Test9999. The
// keys are disposed when execution exits the using statement.
using(RegistryKey
testName = test9999.CreateSubKey("TestName"),
testSettings = test9999.CreateSubKey("TestSettings"))
{
// Create data for the TestSettings subkey.
testSettings.SetValue("Language", "French");
testSettings.SetValue("Level", "Intermediate");
testSettings.SetValue("ID", 123);
}
// Print the information from the Test9999 subkey.
Console.WriteLine("There are {0} subkeys under {1}.",
test9999.SubKeyCount.ToString(), test9999.Name);
foreach(string subKeyName in test9999.GetSubKeyNames())
{
using(RegistryKey
tempKey = test9999.OpenSubKey(subKeyName))
{
Console.WriteLine("\nThere are {0} values for {1}.",
tempKey.ValueCount.ToString(), tempKey.Name);
foreach(string valueName in tempKey.GetValueNames())
{
Console.WriteLine("{0,-8}: {1}", valueName,
tempKey.GetValue(valueName).ToString());
}
}
}
using(RegistryKey
testSettings = test9999.OpenSubKey("TestSettings", true))
{
// Delete the ID value.
testSettings.DeleteValue("id");
// Verify the deletion.
Console.WriteLine((string)testSettings.GetValue(
"id", "ID not found."));
}
// Delete or close the new subkey.
Console.Write("\nDelete newly created registry key? (Y/N) ");
if(Char.ToUpper(Convert.ToChar(Console.Read())) == 'Y')
{
Registry.CurrentUser.DeleteSubKeyTree("Test9999");
Console.WriteLine("\nRegistry key {0} deleted.",
test9999.Name);
}
else
{
Console.WriteLine("\nRegistry key {0} closed.",
test9999.ToString());
test9999.Close();
}
}
}
Imports System.Security.Permissions
Imports Microsoft.Win32
Public Class RegKey
Shared Sub Main()
' Create a subkey named Test9999 under HKEY_CURRENT_USER.
Dim test9999 As RegistryKey = _
Registry.CurrentUser.CreateSubKey("Test9999")
' Create two subkeys under HKEY_CURRENT_USER\Test9999.
test9999.CreateSubKey("TestName").Close()
Dim testSettings As RegistryKey = _
test9999.CreateSubKey("TestSettings")
' Create data for the TestSettings subkey.
testSettings.SetValue("Language", "French")
testSettings.SetValue("Level", "Intermediate")
testSettings.SetValue("ID", 123)
testSettings.Close()
' Print the information from the Test9999 subkey.
Console.WriteLine("There are {0} subkeys under Test9999.", _
test9999.SubKeyCount.ToString())
For Each subKeyName As String In test9999.GetSubKeyNames()
Dim tempKey As RegistryKey = _
test9999.OpenSubKey(subKeyName)
Console.WriteLine(vbCrLf & "There are {0} values for " & _
"{1}.", tempKey.ValueCount.ToString(), tempKey.Name)
For Each valueName As String In tempKey.GetValueNames()
Console.WriteLine("{0,-8}: {1}", valueName, _
tempKey.GetValue(valueName).ToString())
Next
Next
' Delete the ID value.
testSettings = test9999.OpenSubKey("TestSettings", True)
testSettings.DeleteValue("id")
' Verify the deletion.
Console.WriteLine(CType(testSettings.GetValue( _
"id", "ID not found."), String))
testSettings.Close()
' Delete or close the new subkey.
Console.Write(vbCrLf & "Delete newly created " & _
"registry key? (Y/N) ")
If Char.ToUpper(Convert.ToChar(Console.Read())) = "Y"C Then
Registry.CurrentUser.DeleteSubKeyTree("Test9999")
Console.WriteLine(vbCrLf & "Registry key {0} deleted.", _
test9999.Name)
Else
Console.WriteLine(vbCrLf & "Registry key {0} closed.", _
test9999.ToString())
test9999.Close()
End If
End Sub
End Class
備註
若要取得的 RegistryKey實例，請使用 類別的 Registry 其中一個靜態成員。
登錄可作為計算機上作業系統和應用程式資訊的中央存放庫。 登錄是以階層式格式組織，根據儲存在其內的元素邏輯順序， (請參閱 Registry 此階層中的基底層級專案) 。 在登錄中儲存資訊時，請根據所儲存的資訊類型選取適當的位置。 請務必避免終結其他應用程式所建立的信息，因為這可能會導致這些應用程式顯示非預期的行為，而且也會對您自己的應用程式造成負面影響。
重要
此型別代表 IDisposable 介面。 當您完成使用型別時，您應該直接或間接處置它。 若要直接處置型別，請呼叫其 try/catch 區塊中的 Dispose 方法。 若要間接處置它，請使用語言建構函式，例如 using (在 C# 中) 或 Using (在 Visual Basic 中)。 如需詳細資訊，請參閱 IDisposable 介面文章中的＜使用實作 IDisposable 的物件＞一節。
登錄機碼是登錄中組織的基底單位，而且可以與 檔案總管 中的資料夾進行比較。 特定索引鍵可以有子機碼，就像資料夾可以有子資料夾一樣。 只要使用者有適當的許可權可以刪除每個密鑰，而且金鑰不是基底密鑰，或直接在基底索引鍵底下層級即可。 每個索引鍵也可以有多個與其相關聯的值， (值可以與用來儲存資訊的檔案) 進行比較，例如，計算機上所安裝應用程式的相關信息。 每個值都會保留一個特定的資訊片段，必要時可以擷取或更新。 例如，您可以在公司的密鑰 HKEY_LOCAL_MACHINE\Software 下，為公司建立 RegistryKey 子機碼，然後為公司建立的每個應用程式建立子機碼。 每個子機碼都會保留該應用程式特有的資訊，例如色彩設定、螢幕位置和大小，或辨識的擴展名。
請注意，儲存在登錄中的資訊可供其他應用程式和使用者使用，因此不應該用來儲存安全性數據或重要應用程序資訊。
警告
請勿以惡意程式可能會建立數千個無意義的子機碼或索引鍵/值組的方式來公開 RegistryKey 物件。 例如，不允許呼叫端輸入任意索引鍵或值。
從 .NET Framework 4 開始，登錄機碼的長度不再限製為 255 個字元。
屬性
| Handle |
取得 SafeRegistryHandle 物件，這個物件表示目前 RegistryKey 物件所封裝的登錄機碼。 |
| Name |
擷取機碼名稱。 |
| SubKeyCount |
擷取目前機碼中子機碼的計數。 |
| ValueCount |
擷取機碼中值的計數。 |
| View |
取得用來建立登錄機碼的檢視。 |
方法
明確介面實作
| IDisposable.Dispose() |
此 API 支援此產品基礎結構，但無法直接用於程式碼之中。 對目前的機碼執行 Close()。 |
擴充方法
| GetAccessControl(RegistryKey) |
傳回登錄機碼的安全性資訊。 |
| GetAccessControl(RegistryKey, AccessControlSections) |
傳回登錄機碼的安全性資訊。 |
| SetAccessControl(RegistryKey, RegistrySecurity) |
變更現有登錄機碼的安全性屬性。 |
適用於
另請參閱
意見反應
即將登場：在 2024 年，我們將逐步淘汰 GitHub 問題作為內容的意見反應機制，並將它取代為新的意見反應系統。 如需詳細資訊，請參閱：https://aka.ms/ContentUserFeedback。
提交並檢視相關的意見反應