RegistryKey.DeleteValue Metoda

Definicja

Przestrzeń nazw:

Microsoft.Win32

Zestaw:

Microsoft.Win32.Registry.dll

Usuwa określoną wartość z tego klucza i zgłasza wyjątek, jeśli wartość nie zostanie znaleziona.

Przeciążenia

DeleteValue(String)	Usuwa określoną wartość z tego klucza.
DeleteValue(String, Boolean)	Usuwa określoną wartość z tego klucza i określa, czy jest zgłaszany wyjątek, jeśli wartość nie zostanie znaleziona.

DeleteValue(String)

Usuwa określoną wartość z tego klucza.

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

public void DeleteValue (string name);

member this.DeleteValue : string -> unit

Public Sub DeleteValue (name As String)

Parametry

name

String

Nazwa wartości do usunięcia.

Wyjątki

ArgumentException

name nie jest prawidłowym odwołaniem do wartości.

SecurityException

Użytkownik nie ma uprawnień wymaganych do usunięcia wartości.

ObjectDisposedException

Manipulowanie RegistryKey jest zamykane (nie można uzyskać dostępu do zamkniętych kluczy).

UnauthorizedAccessException

Manipulowanie RegistryKey jest tylko do odczytu.

Przykłady

Ten przykład kodu jest częścią większego przykładu podanego RegistryKey dla klasy.

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

Zobacz też

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

DeleteValue(String, Boolean)

Usuwa określoną wartość z tego klucza i określa, czy jest zgłaszany wyjątek, jeśli wartość nie zostanie znaleziona.

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)

Parametry

name

String

Nazwa wartości do usunięcia.

throwOnMissingValue

Boolean

Wskazuje, czy należy podnieść wyjątek, jeśli nie można odnaleźć określonej wartości. Jeśli ten argument jest true i określona wartość nie istnieje, zostanie zgłoszony wyjątek. Jeśli ten argument jest false i określona wartość nie istnieje, nie zostanie podjęta żadna akcja.

Wyjątki

ArgumentException

name nie jest prawidłowym odwołaniem do wartości i throwOnMissingValue jest true.

-lub-

name to null.

SecurityException

Użytkownik nie ma uprawnień wymaganych do usunięcia wartości.

ObjectDisposedException

Manipulowanie RegistryKey jest zamykane (nie można uzyskać dostępu do zamkniętych kluczy).

UnauthorizedAccessException

Manipulowanie RegistryKey jest tylko do odczytu.

Uwagi

Jeśli throwOnMissingValue jest falseto , nie ma możliwości informowania, czy usunięcie zakończyło się pomyślnie, bez próby uzyskania dostępu do wartości właśnie usuniętej. Dlatego należy zachować ostrożność podczas usuwania wartości z rejestru w ten sposób.

Zobacz też

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