Interaction.DeleteSetting(String, String, String) Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Elimina una sección o configuración de clave de la entrada de una aplicación en el Registro de Windows. La característica My proporciona mayor productividad y rendimiento en las operaciones del Registro que la función DeleteSetting. Para obtener más información, consulta Registry.
[System.Runtime.Versioning.SupportedOSPlatform("windows")]
public static void DeleteSetting (string AppName, string? Section = default, string? Key = default);public static void DeleteSetting (string AppName, string Section = default, string Key = default);[<System.Runtime.Versioning.SupportedOSPlatform("windows")>]
static member DeleteSetting : string * string * string -> unitstatic member DeleteSetting : string * string * string -> unitPublic Sub DeleteSetting (AppName As String, Optional Section As String = Nothing, Optional Key As String = Nothing)Parámetros
- AppName
- String
Obligatorio. Expresión de tipo String que contiene el nombre de la aplicación o el proyecto al que corresponde la sección o clave.
- Section
- String
Obligatorio. Expresión de tipo String que contiene el nombre de la sección de la que se va a eliminar la configuración de clave. Si se proporcionan sólo AppName y Section, se elimina la sección especificada junto con todas las configuraciones de clave relacionadas.
- Key
- String
Opcional. Expresión de tipo String que contiene el nombre de la configuración de clave que se va a eliminar.
- Atributos
Excepciones
El usuario no ha iniciado la sesión.
Ejemplos
En el ejemplo siguiente se usa primero el SaveSetting procedimiento para realizar entradas en el Registro de Windows para la MyApp aplicación y, a continuación, se usa la DeleteSetting función para quitarlas. Dado que no se especifica ningún Key argumento, se elimina toda Startup la sección, incluido el nombre de la sección y todas sus claves.
' Place some settings in the registry.
SaveSetting("MyApp", "Startup", "Top", "75")
SaveSetting("MyApp", "Startup", "Left", "50")
' Remove section and all its settings from registry.
DeleteSetting("MyApp", "Startup")
' Remove MyApp from the registry.
DeleteSetting("MyApp")
Comentarios
Si se proporcionan todos los argumentos, se elimina la configuración especificada. Se produce un error en tiempo de ejecución si intenta usar DeleteSetting en una sección o configuración de clave inexistentes.
DeleteSetting requiere que un usuario inicie sesión porque funciona con la clave del HKEY_LOCAL_USER Registro, que no está activa hasta que un usuario inicia sesión de forma interactiva.
La configuración del Registro a la que se va a acceder desde un proceso no interactivo (por ejemplo, Mtx.exe) debe almacenarse en las HKEY_LOCAL_MACHINE\Software\ claves del Registro o HKEY_USER\DEFAULT\Software .
