RegistryKey.DeleteValue Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
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 -> unitPublic 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 -> unitPublic 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.
