Bagikan melalui


RegistryKey.CreateSubKey Metode

Definisi

Membuat subkunci baru atau membuka subkunci yang ada.

Overload

CreateSubKey(String)

Membuat subkunci baru atau membuka subkunci yang ada untuk akses tulis.

CreateSubKey(String, RegistryKeyPermissionCheck)

Membuat subkunci baru atau membuka subkunci yang ada untuk akses tulis, menggunakan opsi centang izin yang ditentukan.

CreateSubKey(String, Boolean)

Membuat subkunci baru atau membuka subkunci yang ada dengan akses yang ditentukan. Tersedia dimulai dengan .NET Framework 4.6.

CreateSubKey(String, RegistryKeyPermissionCheck, RegistrySecurity)

Membuat subkunci baru atau membuka subkunci yang ada untuk akses tulis, menggunakan opsi pemeriksaan izin dan keamanan registri yang ditentukan.

CreateSubKey(String, Boolean, RegistryOptions)

Membuat subkunci baru atau membuka subkunci yang ada dengan akses yang ditentukan. Tersedia dimulai dengan .NET Framework 4.6.

CreateSubKey(String, RegistryKeyPermissionCheck, RegistryOptions)

Membuat subkunci atau membuka subkunci untuk akses tulis, menggunakan opsi pemeriksaan izin dan registri yang ditentukan.

CreateSubKey(String, RegistryKeyPermissionCheck, RegistryOptions, RegistrySecurity)

Membuat subkunci atau membuka subkunci untuk akses tulis, menggunakan opsi pemeriksaan izin, opsi registri, dan keamanan registri yang ditentukan.

CreateSubKey(String)

Sumber:
RegistryKey.cs

Membuat subkunci baru atau membuka subkunci yang ada untuk akses tulis.

public:
 Microsoft::Win32::RegistryKey ^ CreateSubKey(System::String ^ subkey);
public Microsoft.Win32.RegistryKey CreateSubKey (string subkey);
member this.CreateSubKey : string -> Microsoft.Win32.RegistryKey
Public Function CreateSubKey (subkey As String) As RegistryKey

Parameter

subkey
String

Nama atau jalur subkunci untuk membuat atau membuka. String ini tidak peka huruf besar/kecil.

Mengembalikan

Subkunci yang baru dibuat, atau null jika operasi gagal. Jika string panjang nol ditentukan untuk subkey, objek saat ini RegistryKey dikembalikan.

Pengecualian

subkeyadalah null.

Pengguna tidak memiliki izin yang diperlukan untuk membuat atau membuka kunci registri.

Di RegistryKey mana metode ini sedang dipanggil ditutup (kunci tertutup tidak dapat diakses).

RegistryKey tidak dapat ditulis ke; misalnya, itu tidak dibuka sebagai kunci bisa-tulis , atau pengguna tidak memiliki hak akses yang diperlukan.

Tingkat bersarang melebihi 510.

-atau-

Terjadi kesalahan sistem, seperti penghapusan kunci, atau upaya untuk membuat kunci di LocalMachine akar.

Contoh

Contoh kode berikut menunjukkan cara membuat subkunci di bawah HKEY_CURRENT_USER, memanipulasi kontennya, lalu menghapus subkunci.

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

Keterangan

Untuk melakukan tindakan ini, pengguna harus memiliki izin pada tingkat ini dan di bawah ini dalam hierarki registri.

Perhatian

Jangan mengekspos RegistryKey objek semikian rupa sehingga program berbahaya dapat membuat ribuan subkunci atau pasangan kunci/nilai yang tidak berarti. Misalnya, jangan izinkan penelepon untuk memasukkan kunci atau nilai arbitrer.

Lihat juga

Berlaku untuk

CreateSubKey(String, RegistryKeyPermissionCheck)

Sumber:
RegistryKey.cs

Membuat subkunci baru atau membuka subkunci yang ada untuk akses tulis, menggunakan opsi centang izin yang ditentukan.

public:
 Microsoft::Win32::RegistryKey ^ CreateSubKey(System::String ^ subkey, Microsoft::Win32::RegistryKeyPermissionCheck permissionCheck);
public Microsoft.Win32.RegistryKey CreateSubKey (string subkey, Microsoft.Win32.RegistryKeyPermissionCheck permissionCheck);
[System.Runtime.InteropServices.ComVisible(false)]
public Microsoft.Win32.RegistryKey CreateSubKey (string subkey, Microsoft.Win32.RegistryKeyPermissionCheck permissionCheck);
member this.CreateSubKey : string * Microsoft.Win32.RegistryKeyPermissionCheck -> Microsoft.Win32.RegistryKey
[<System.Runtime.InteropServices.ComVisible(false)>]
member this.CreateSubKey : string * Microsoft.Win32.RegistryKeyPermissionCheck -> Microsoft.Win32.RegistryKey
Public Function CreateSubKey (subkey As String, permissionCheck As RegistryKeyPermissionCheck) As RegistryKey

Parameter

subkey
String

Nama atau jalur subkunci untuk membuat atau membuka. String ini tidak peka huruf besar/kecil.

permissionCheck
RegistryKeyPermissionCheck

Salah satu nilai enumerasi yang menentukan apakah kunci dibuka untuk akses baca atau baca/tulis.

Mengembalikan

Subkunci yang baru dibuat, atau null jika operasi gagal. Jika string panjang nol ditentukan untuk subkey, objek saat ini RegistryKey dikembalikan.

Atribut

Pengecualian

subkeyadalah null.

Pengguna tidak memiliki izin yang diperlukan untuk membuat atau membuka kunci registri.

permissionCheck berisi nilai yang tidak valid.

Di RegistryKey mana metode ini sedang dipanggil ditutup (kunci tertutup tidak dapat diakses).

RegistryKey tidak dapat ditulis ke; misalnya, itu tidak dibuka sebagai kunci bisa-tulis, atau pengguna tidak memiliki hak akses yang diperlukan.

Tingkat bersarang melebihi 510.

-atau-

Terjadi kesalahan sistem, seperti penghapusan kunci, atau upaya untuk membuat kunci di LocalMachine akar.

Keterangan

Untuk melakukan tindakan ini, pengguna harus memiliki izin pada tingkat ini dan di bawah ini dalam hierarki registri.

Perhatian

Jangan mengekspos RegistryKey objek semikian rupa sehingga program berbahaya dapat membuat ribuan subkunci atau pasangan kunci/nilai yang tidak berarti. Misalnya, jangan izinkan penelepon untuk memasukkan kunci atau nilai arbitrer.

Untuk menggunakan metode ini OpenSubKey , Anda harus memiliki instans RegistryKey kelas . Untuk mendapatkan instans RegistryKey, gunakan salah satu anggota Registry statis kelas.

Lihat juga

Berlaku untuk

CreateSubKey(String, Boolean)

Sumber:
RegistryKey.cs

Membuat subkunci baru atau membuka subkunci yang ada dengan akses yang ditentukan. Tersedia dimulai dengan .NET Framework 4.6.

public:
 Microsoft::Win32::RegistryKey ^ CreateSubKey(System::String ^ subkey, bool writable);
public Microsoft.Win32.RegistryKey CreateSubKey (string subkey, bool writable);
[System.Runtime.InteropServices.ComVisible(false)]
public Microsoft.Win32.RegistryKey CreateSubKey (string subkey, bool writable);
member this.CreateSubKey : string * bool -> Microsoft.Win32.RegistryKey
[<System.Runtime.InteropServices.ComVisible(false)>]
member this.CreateSubKey : string * bool -> Microsoft.Win32.RegistryKey
Public Function CreateSubKey (subkey As String, writable As Boolean) As RegistryKey

Parameter

subkey
String

Nama atau jalur subkunci untuk membuat atau membuka. String ini tidak peka huruf besar/kecil.

writable
Boolean

true untuk menunjukkan subkunjuk baru dapat ditulis; jika tidak, false.

Mengembalikan

Subkunci yang baru dibuat, atau null jika operasi gagal. Jika string panjang nol ditentukan untuk subkey, objek saat ini RegistryKey dikembalikan.

Atribut

Pengecualian

subkeyadalah null.

Pengguna tidak memiliki izin yang diperlukan untuk membuat atau membuka kunci registri.

Saat ini RegistryKey tidak dapat ditulis ke; misalnya, itu tidak dibuka sebagai kunci bisa-tulis, atau pengguna tidak memiliki hak akses yang diperlukan.

Tingkat bersarang melebihi 510.

-atau-

Terjadi kesalahan sistem, seperti penghapusan kunci, atau upaya untuk membuat kunci di LocalMachine akar.

Keterangan

Untuk melakukan tindakan ini, pengguna harus memiliki izin pada tingkat ini dan di bawah ini dalam hierarki registri.

Perhatian

Jangan mengekspos RegistryKey objek semikian rupa sehingga program berbahaya dapat membuat ribuan subkunci atau pasangan kunci/nilai yang tidak berarti. Misalnya, jangan izinkan penelepon untuk memasukkan kunci atau nilai arbitrer.

Untuk menggunakan metode ini CreateSubKey , Anda harus memiliki instans RegistryKey kelas . Untuk mendapatkan instans RegistryKey, gunakan salah satu anggota Registry statis kelas.

Berlaku untuk

CreateSubKey(String, RegistryKeyPermissionCheck, RegistrySecurity)

Sumber:
RegistryKey.cs

Membuat subkunci baru atau membuka subkunci yang ada untuk akses tulis, menggunakan opsi pemeriksaan izin dan keamanan registri yang ditentukan.

public:
 Microsoft::Win32::RegistryKey ^ CreateSubKey(System::String ^ subkey, Microsoft::Win32::RegistryKeyPermissionCheck permissionCheck, System::Security::AccessControl::RegistrySecurity ^ registrySecurity);
public Microsoft.Win32.RegistryKey CreateSubKey (string subkey, Microsoft.Win32.RegistryKeyPermissionCheck permissionCheck, System.Security.AccessControl.RegistrySecurity registrySecurity);
public Microsoft.Win32.RegistryKey CreateSubKey (string subkey, Microsoft.Win32.RegistryKeyPermissionCheck permissionCheck, System.Security.AccessControl.RegistrySecurity? registrySecurity);
[System.Runtime.InteropServices.ComVisible(false)]
public Microsoft.Win32.RegistryKey CreateSubKey (string subkey, Microsoft.Win32.RegistryKeyPermissionCheck permissionCheck, System.Security.AccessControl.RegistrySecurity registrySecurity);
member this.CreateSubKey : string * Microsoft.Win32.RegistryKeyPermissionCheck * System.Security.AccessControl.RegistrySecurity -> Microsoft.Win32.RegistryKey
[<System.Runtime.InteropServices.ComVisible(false)>]
member this.CreateSubKey : string * Microsoft.Win32.RegistryKeyPermissionCheck * System.Security.AccessControl.RegistrySecurity -> Microsoft.Win32.RegistryKey
Public Function CreateSubKey (subkey As String, permissionCheck As RegistryKeyPermissionCheck, registrySecurity As RegistrySecurity) As RegistryKey

Parameter

subkey
String

Nama atau jalur subkunci untuk membuat atau membuka. String ini tidak peka huruf besar/kecil.

permissionCheck
RegistryKeyPermissionCheck

Salah satu nilai enumerasi yang menentukan apakah kunci dibuka untuk akses baca atau baca/tulis.

registrySecurity
RegistrySecurity

Keamanan kontrol akses untuk kunci baru.

Mengembalikan

Subkunci yang baru dibuat, atau null jika operasi gagal. Jika string panjang nol ditentukan untuk subkey, objek saat ini RegistryKey dikembalikan.

Atribut

Pengecualian

subkeyadalah null.

Pengguna tidak memiliki izin yang diperlukan untuk membuat atau membuka kunci registri.

permissionCheck berisi nilai yang tidak valid.

Di RegistryKey mana metode ini sedang dipanggil ditutup (kunci tertutup tidak dapat diakses).

Saat ini RegistryKey tidak dapat ditulis ke; misalnya, itu tidak dibuka sebagai kunci bisa-tulis, atau pengguna tidak memiliki hak akses yang diperlukan.

Tingkat bersarang melebihi 510.

-atau-

Terjadi kesalahan sistem, seperti penghapusan kunci, atau upaya untuk membuat kunci di LocalMachine akar.

Keterangan

Metode ini CreateSubKey membuat kunci registri yang memiliki kontrol akses yang ditentukan oleh registrySecurity parameter . Objek RegistryKey yang dikembalikan mewakili kunci registri, tetapi objek tersebut tidak dibatasi oleh kontrol akses yang ditentukan dalam registrySecurity parameter .

Jika permissionCheck adalah RegistryKeyPermissionCheck.ReadWriteSubTree, kunci dibuka untuk akses baca/tulis. Jika permissionCheck adalah RegistryKeyPermissionCheck.ReadSubTree, kunci dibuka untuk akses baca.

Untuk kompatibilitas mundur, kunci dibuka untuk membaca dan menulis apakah permissionCheck ada RegistryKeyPermissionCheck.Default dan kunci induk juga memiliki RegistryKeyPermissionCheck.Default. Jika kunci induk memiliki pengaturan lain, status baca/tulis dikontrol oleh pengaturan kunci induk.

Untuk melakukan tindakan ini, pengguna harus memiliki izin pada tingkat ini dan di bawah ini dalam hierarki registri.

Perhatian

Jangan mengekspos RegistryKey objek semikian rupa sehingga program berbahaya dapat membuat ribuan subkunci atau pasangan kunci/nilai yang tidak berarti. Misalnya, jangan izinkan penelepon untuk memasukkan kunci atau nilai arbitrer.

Untuk menggunakan metode ini OpenSubKey , Anda harus memiliki instans RegistryKey kelas . Untuk mendapatkan instans RegistryKey, gunakan salah satu anggota Registry statis kelas.

Lihat juga

Berlaku untuk

CreateSubKey(String, Boolean, RegistryOptions)

Sumber:
RegistryKey.cs

Membuat subkunci baru atau membuka subkunci yang ada dengan akses yang ditentukan. Tersedia dimulai dengan .NET Framework 4.6.

public:
 Microsoft::Win32::RegistryKey ^ CreateSubKey(System::String ^ subkey, bool writable, Microsoft::Win32::RegistryOptions options);
public Microsoft.Win32.RegistryKey CreateSubKey (string subkey, bool writable, Microsoft.Win32.RegistryOptions options);
[System.Runtime.InteropServices.ComVisible(false)]
public Microsoft.Win32.RegistryKey CreateSubKey (string subkey, bool writable, Microsoft.Win32.RegistryOptions options);
member this.CreateSubKey : string * bool * Microsoft.Win32.RegistryOptions -> Microsoft.Win32.RegistryKey
[<System.Runtime.InteropServices.ComVisible(false)>]
member this.CreateSubKey : string * bool * Microsoft.Win32.RegistryOptions -> Microsoft.Win32.RegistryKey
Public Function CreateSubKey (subkey As String, writable As Boolean, options As RegistryOptions) As RegistryKey

Parameter

subkey
String

Nama atau jalur subkunci untuk membuat atau membuka. String ini tidak peka huruf besar/kecil.

writable
Boolean

true untuk menunjukkan subkunjuk baru dapat ditulis; jika tidak, false.

options
RegistryOptions

Opsi registri untuk digunakan.

Mengembalikan

Subkunci yang baru dibuat, atau null jika operasi gagal. Jika string panjang nol ditentukan untuk subkey, objek saat ini RegistryKey dikembalikan.

Atribut

Pengecualian

subkeyadalah null.

options tidak menentukan Opsi yang valid.

Pengguna tidak memiliki izin yang diperlukan untuk membuat atau membuka kunci registri.

Saat ini RegistryKey tidak dapat ditulis ke; misalnya, itu tidak dibuka sebagai kunci bisa-tulis, atau pengguna tidak memiliki hak akses yang diperlukan.

Tingkat bersarang melebihi 510.

-atau-

Terjadi kesalahan sistem, seperti penghapusan kunci, atau upaya untuk membuat kunci di LocalMachine akar.

Keterangan

Untuk melakukan tindakan ini, pengguna harus memiliki izin pada tingkat ini dan di bawah ini dalam hierarki registri.

Perhatian

Jangan mengekspos RegistryKey objek semikian rupa sehingga program berbahaya dapat membuat ribuan subkunci atau pasangan kunci/nilai yang tidak berarti. Misalnya, jangan izinkan penelepon untuk memasukkan kunci atau nilai arbitrer.

Untuk menggunakan metode ini CreateSubKey , Anda harus memiliki instans RegistryKey kelas . Untuk mendapatkan instans RegistryKey, gunakan salah satu anggota Registry statis kelas.

Berlaku untuk

CreateSubKey(String, RegistryKeyPermissionCheck, RegistryOptions)

Sumber:
RegistryKey.cs

Membuat subkunci atau membuka subkunci untuk akses tulis, menggunakan opsi pemeriksaan izin dan registri yang ditentukan.

public:
 Microsoft::Win32::RegistryKey ^ CreateSubKey(System::String ^ subkey, Microsoft::Win32::RegistryKeyPermissionCheck permissionCheck, Microsoft::Win32::RegistryOptions registryOptions);
public:
 Microsoft::Win32::RegistryKey ^ CreateSubKey(System::String ^ subkey, Microsoft::Win32::RegistryKeyPermissionCheck permissionCheck, Microsoft::Win32::RegistryOptions options);
public Microsoft.Win32.RegistryKey CreateSubKey (string subkey, Microsoft.Win32.RegistryKeyPermissionCheck permissionCheck, Microsoft.Win32.RegistryOptions registryOptions);
[System.Runtime.InteropServices.ComVisible(false)]
public Microsoft.Win32.RegistryKey CreateSubKey (string subkey, Microsoft.Win32.RegistryKeyPermissionCheck permissionCheck, Microsoft.Win32.RegistryOptions options);
member this.CreateSubKey : string * Microsoft.Win32.RegistryKeyPermissionCheck * Microsoft.Win32.RegistryOptions -> Microsoft.Win32.RegistryKey
[<System.Runtime.InteropServices.ComVisible(false)>]
member this.CreateSubKey : string * Microsoft.Win32.RegistryKeyPermissionCheck * Microsoft.Win32.RegistryOptions -> Microsoft.Win32.RegistryKey
Public Function CreateSubKey (subkey As String, permissionCheck As RegistryKeyPermissionCheck, registryOptions As RegistryOptions) As RegistryKey
Public Function CreateSubKey (subkey As String, permissionCheck As RegistryKeyPermissionCheck, options As RegistryOptions) As RegistryKey

Parameter

subkey
String

Nama atau jalur subkunci untuk membuat atau membuka.

permissionCheck
RegistryKeyPermissionCheck

Salah satu nilai enumerasi yang menentukan apakah kunci dibuka untuk akses baca atau baca/tulis.

registryOptionsoptions
RegistryOptions

Opsi registri untuk digunakan; misalnya, yang membuat kunci volatil.

Mengembalikan

Subkunci yang baru dibuat, atau null jika operasi gagal.

Atribut

Pengecualian

subkeyadalah null.

Objek saat ini RegistryKey ditutup (kunci tertutup tidak dapat diakses).

Objek saat ini RegistryKey tidak dapat ditulis; misalnya, objek tidak dibuka sebagai kunci bisa-tulis, atau pengguna tidak memiliki hak akses yang diperlukan.

Tingkat bersarang melebihi 510.

-atau-

Terjadi kesalahan sistem, seperti penghapusan kunci atau upaya untuk membuat kunci di LocalMachine akar.

Pengguna tidak memiliki izin yang diperlukan untuk membuat atau membuka kunci registri.

Keterangan

Untuk mendapatkan objek saat ini RegistryKey , tentukan string kosong ("") untuk subkey.

Berlaku untuk

CreateSubKey(String, RegistryKeyPermissionCheck, RegistryOptions, RegistrySecurity)

Sumber:
RegistryKey.cs

Membuat subkunci atau membuka subkunci untuk akses tulis, menggunakan opsi pemeriksaan izin, opsi registri, dan keamanan registri yang ditentukan.

public:
 Microsoft::Win32::RegistryKey ^ CreateSubKey(System::String ^ subkey, Microsoft::Win32::RegistryKeyPermissionCheck permissionCheck, Microsoft::Win32::RegistryOptions registryOptions, System::Security::AccessControl::RegistrySecurity ^ registrySecurity);
public Microsoft.Win32.RegistryKey CreateSubKey (string subkey, Microsoft.Win32.RegistryKeyPermissionCheck permissionCheck, Microsoft.Win32.RegistryOptions registryOptions, System.Security.AccessControl.RegistrySecurity registrySecurity);
public Microsoft.Win32.RegistryKey CreateSubKey (string subkey, Microsoft.Win32.RegistryKeyPermissionCheck permissionCheck, Microsoft.Win32.RegistryOptions registryOptions, System.Security.AccessControl.RegistrySecurity? registrySecurity);
[System.Runtime.InteropServices.ComVisible(false)]
public Microsoft.Win32.RegistryKey CreateSubKey (string subkey, Microsoft.Win32.RegistryKeyPermissionCheck permissionCheck, Microsoft.Win32.RegistryOptions registryOptions, System.Security.AccessControl.RegistrySecurity registrySecurity);
member this.CreateSubKey : string * Microsoft.Win32.RegistryKeyPermissionCheck * Microsoft.Win32.RegistryOptions * System.Security.AccessControl.RegistrySecurity -> Microsoft.Win32.RegistryKey
[<System.Runtime.InteropServices.ComVisible(false)>]
member this.CreateSubKey : string * Microsoft.Win32.RegistryKeyPermissionCheck * Microsoft.Win32.RegistryOptions * System.Security.AccessControl.RegistrySecurity -> Microsoft.Win32.RegistryKey
Public Function CreateSubKey (subkey As String, permissionCheck As RegistryKeyPermissionCheck, registryOptions As RegistryOptions, registrySecurity As RegistrySecurity) As RegistryKey

Parameter

subkey
String

Nama atau jalur subkunci untuk membuat atau membuka.

permissionCheck
RegistryKeyPermissionCheck

Salah satu nilai enumerasi yang menentukan apakah kunci dibuka untuk akses baca atau baca/tulis.

registryOptions
RegistryOptions

Opsi registri untuk digunakan.

registrySecurity
RegistrySecurity

Keamanan kontrol akses untuk subkuncar baru.

Mengembalikan

Subkunci yang baru dibuat, atau null jika operasi gagal.

Atribut

Pengecualian

subkeyadalah null.

Objek saat ini RegistryKey ditutup. Kunci tertutup tidak dapat diakses.

Objek saat ini RegistryKey tidak dapat ditulis; misalnya, objek tidak dibuka sebagai kunci bisa-tulis, atau pengguna tidak memiliki hak akses yang diperlukan.

Tingkat bersarang melebihi 510.

-atau-

Terjadi kesalahan sistem, seperti penghapusan kunci atau upaya untuk membuat kunci di LocalMachine akar.

Pengguna tidak memiliki izin yang diperlukan untuk membuat atau membuka kunci registri.

Keterangan

Untuk mendapatkan objek saat ini RegistryKey , tentukan string kosong ("") untuk subkey.

Berlaku untuk