RegistryKey.DeleteValue Metode

Definisi

Ruang nama:

Microsoft.Win32

Rakitan:

Microsoft.Win32.Registry.dll

Menghapus nilai yang ditentukan dari kunci ini, dan melemparkan pengecualian jika nilai tidak ditemukan.

Overload

DeleteValue(String)	Menghapus nilai yang ditentukan dari kunci ini.
DeleteValue(String, Boolean)	Menghapus nilai yang ditentukan dari kunci ini, dan menentukan apakah pengecualian dinaikkan jika nilai tidak ditemukan.

DeleteValue(String)

Menghapus nilai yang ditentukan dari kunci ini.

public:
 void DeleteValue(System::String ^ name);

public void DeleteValue (string name);

member this.DeleteValue : string -> unit

Public Sub DeleteValue (name As String)

Parameter

name

String

Nama nilai yang akan dihapus.

Pengecualian

ArgumentException

name bukan referensi yang valid ke nilai.

SecurityException

Pengguna tidak memiliki izin yang diperlukan untuk menghapus nilai.

ObjectDisposedException

Yang RegistryKey sedang dimanipulasi ditutup (kunci tertutup tidak dapat diakses).

UnauthorizedAccessException

Yang RegistryKey sedang dimanipulasi adalah baca-saja.

Contoh

Contoh kode ini adalah bagian dari contoh yang lebih besar yang disediakan untuk RegistryKey kelas .

// 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();

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 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()

Lihat juga

• DeleteSubKey(String)
• OpenSubKey(String, Boolean)
• GetValue(String)
• GetValueNames()
• ValueCount

DeleteValue(String, Boolean)

Menghapus nilai yang ditentukan dari kunci ini, dan menentukan apakah pengecualian dinaikkan jika nilai tidak ditemukan.

public:
 void DeleteValue(System::String ^ name, bool throwOnMissingValue);

public void DeleteValue (string name, bool throwOnMissingValue);

member this.DeleteValue : string * bool -> unit

Public Sub DeleteValue (name As String, throwOnMissingValue As Boolean)

Parameter

name

String

Nama nilai yang akan dihapus.

throwOnMissingValue

Boolean

Menunjukkan apakah pengecualian harus dinaikkan jika nilai yang ditentukan tidak dapat ditemukan. Jika argumen ini adalah true dan nilai yang ditentukan tidak ada, pengecualian akan dimunculkan. Jika argumen ini adalah false dan nilai yang ditentukan tidak ada, tidak ada tindakan yang diambil.

Pengecualian

ArgumentException

name bukan referensi yang valid ke nilai dan throwOnMissingValue adalah true.

-atau-

nameadalah null.

SecurityException

Pengguna tidak memiliki izin yang diperlukan untuk menghapus nilai.

ObjectDisposedException

Yang RegistryKey sedang dimanipulasi ditutup (kunci tertutup tidak dapat diakses).

UnauthorizedAccessException

Yang RegistryKey sedang dimanipulasi adalah baca-saja.

Keterangan

Jika throwOnMissingValue adalah false, tidak ada cara untuk mengetahui apakah penghapusan berhasil, tanpa kemudian mencoba mengakses nilai yang baru saja dihapus. Oleh karena itu, berhati-hatilah saat menghapus nilai dari registri dengan cara ini.

Lihat juga

• DeleteSubKey(String)
• OpenSubKey(String, Boolean)
• GetValue(String)
• GetValueNames()
• ValueCount