RegistryKey.DeleteValue Yöntem

  • Başvuru

Tanım

Ad Alanı:
Microsoft.Win32
Bütünleştirilmiş Kod:
Microsoft.Win32.Registry.dll
Bütünleştirilmiş Kod:
mscorlib.dll

Belirtilen değeri bu anahtardan siler ve değer bulunamazsa bir özel durum oluşturur.

Aşırı Yüklemeler

DeleteValue(String)

Belirtilen değeri bu anahtardan siler.
DeleteValue(String, Boolean)

Belirtilen değeri bu anahtardan siler ve değer bulunamazsa bir özel durumun tetiklenip tetiklenmeyeceğini belirtir.

DeleteValue(String)

Kaynak:
RegistryKey.cs

Belirtilen değeri bu anahtardan siler.

public:
 void DeleteValue(System::String ^ name);
public void DeleteValue (string name);
member this.DeleteValue : string -> unit
Public Sub DeleteValue (name As String)

Parametreler

name
String

Silinecek değerin adı.

Özel durumlar

ArgumentException

name bir değere geçerli bir başvuru değildir.

SecurityException

Kullanıcının değeri silmek için gereken izinleri yok.

ObjectDisposedException

İşlenen RegistryKey kapatılır (kapalı anahtarlara erişilemez).

UnauthorizedAccessException

Manipüle RegistryKey edilen salt okunurdur.

Örnekler

Bu kod örneği, sınıfı için RegistryKey sağlanan daha büyük bir örneğin parçasıdır.

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

Ayrıca bkz.

Şunlara uygulanır

DeleteValue(String, Boolean)

Kaynak:
RegistryKey.cs

Belirtilen değeri bu anahtardan siler ve değer bulunamazsa bir özel durumun tetiklenip tetiklenmeyeceğini belirtir.

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)

Parametreler

name
String

Silinecek değerin adı.

throwOnMissingValue
Boolean

Belirtilen değer bulunamazsa bir özel durumun tetiklenip tetiklenmeyeceğini gösterir. Bu bağımsız değişken ise true ve belirtilen değer yoksa, bir özel durum oluşturulur. Bu bağımsız değişken ise false ve belirtilen değer yoksa hiçbir eylem yapılmaz.

Özel durumlar

ArgumentException

name bir değere geçerli bir başvuru değildir ve throwOnMissingValue değeridir true.

-veya-

name, null değeridir.

SecurityException

Kullanıcının değeri silmek için gereken izinleri yok.

ObjectDisposedException

İşlenen RegistryKey kapatılır (kapalı anahtarlara erişilemez).

UnauthorizedAccessException

Manipüle RegistryKey edilen salt okunurdur.

Açıklamalar

ise throwOnMissingValuefalse, silme işleminin başarılı olup olmadığını daha sonra yeni silinen değere erişmeye çalışmadan ayırt etmenin bir yolu yoktur. Bu nedenle, kayıt defterinden değerleri bu şekilde silerken dikkatli olun.

Ayrıca bkz.

Şunlara uygulanır