Udostępnij za pośrednictwem


RegistryKey.DeleteValue Metoda

Definicja

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)

Źródło:
RegistryKey.cs

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

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

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

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

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ż

Dotyczy

DeleteValue(String, Boolean)

Źródło:
RegistryKey.cs

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

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

-lub-

name to null.

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

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

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ż

Dotyczy