RegistryKey.DeleteValue Yöntem

Tanım

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

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

Aşırı Yüklemeler

Name Description
DeleteValue(String)

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

Belirtilen değeri bu anahtardan siler ve değer bulunamazsa ö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 geçerli bir değer başvurusu değildir.

SecurityException

Kullanıcı, değeri silmek için gereken izinlere sahip değil.

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 ö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 özel durum oluşturulup oluşturulmayacağını 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 geçerli bir değer başvurusu değildir ve throwOnMissingValue şeklindedir true.

-veya-

name, null'e eşittir.

SecurityException

Kullanıcı, değeri silmek için gereken izinlere sahip değil.

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ı anlamanın bir yolu yoktur; daha sonra yeni silinen değere erişmeye çalışmadan. Bu nedenle, kayıt defterinden değerleri bu şekilde silerken dikkatli olun.

Ayrıca bkz.

Şunlara uygulanır