RegistryKey.CreateSubKey Metode

Referensi

Definisi

Ruang nama:: Microsoft.Win32

Rakitan:: Microsoft.Win32.Registry.dll

Rakitan:: mscorlib.dll

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

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

RegistryKey

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

Pengecualian

ArgumentNullException

subkeyadalah null.

SecurityException

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

ObjectDisposedException

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

UnauthorizedAccessException

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

IOException

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

RegistryKey

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

Atribut: ComVisibleAttribute

Pengecualian

ArgumentNullException

subkeyadalah null.

SecurityException

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

ArgumentException

permissionCheck berisi nilai yang tidak valid.

ObjectDisposedException

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

UnauthorizedAccessException

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

IOException

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

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

RegistryKey

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

Atribut: ComVisibleAttribute

Pengecualian

ArgumentNullException

subkeyadalah null.

SecurityException

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

UnauthorizedAccessException

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

IOException

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

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

RegistryKey

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

Atribut: ComVisibleAttribute

Pengecualian

ArgumentNullException

subkeyadalah null.

SecurityException

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

ArgumentException

permissionCheck berisi nilai yang tidak valid.

ObjectDisposedException

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

UnauthorizedAccessException

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

IOException

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

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

RegistryKey

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

Atribut: ComVisibleAttribute

Pengecualian

ArgumentNullException

subkeyadalah null.

ArgumentException

options tidak menentukan Opsi yang valid.

SecurityException

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

UnauthorizedAccessException

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

IOException

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

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

RegistryKey

Subkunci yang baru dibuat, atau null jika operasi gagal.

Atribut: ComVisibleAttribute

Pengecualian

ArgumentNullException

subkeyadalah null.

ObjectDisposedException

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

UnauthorizedAccessException

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

IOException

Tingkat bersarang melebihi 510.

-atau-

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

SecurityException

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

RegistryKey

Subkunci yang baru dibuat, atau null jika operasi gagal.

Atribut: ComVisibleAttribute

Pengecualian

ArgumentNullException

subkeyadalah null.

ObjectDisposedException

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

UnauthorizedAccessException

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

IOException

Tingkat bersarang melebihi 510.

-atau-

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

SecurityException

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

Bagikan melalui

RegistryKey.CreateSubKey Metode

Definisi

Overload

CreateSubKey(String)

Parameter

Mengembalikan

Pengecualian

Contoh

Keterangan

Lihat juga

Berlaku untuk

CreateSubKey(String, RegistryKeyPermissionCheck)

Parameter

Mengembalikan

Pengecualian

Keterangan

Lihat juga

Berlaku untuk

CreateSubKey(String, Boolean)

Parameter

Mengembalikan

Pengecualian

Keterangan

Berlaku untuk

CreateSubKey(String, RegistryKeyPermissionCheck, RegistrySecurity)

Parameter

Mengembalikan

Pengecualian

Keterangan

Lihat juga

Berlaku untuk

CreateSubKey(String, Boolean, RegistryOptions)

Parameter

Mengembalikan

Pengecualian

Keterangan

Berlaku untuk

CreateSubKey(String, RegistryKeyPermissionCheck, RegistryOptions)

Parameter

Mengembalikan

Pengecualian

Keterangan

Berlaku untuk

CreateSubKey(String, RegistryKeyPermissionCheck, RegistryOptions, RegistrySecurity)

Parameter

Mengembalikan

Pengecualian

Keterangan

Berlaku untuk

Sumber Daya Tambahan: