Interaction.DeleteSetting(String, String, String) Método

Definición

Espacio de nombres:

Microsoft.VisualBasic

Ensamblado:

Microsoft.VisualBasic.Core.dll

Source:

Interaction.vb

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);

[<System.Runtime.Versioning.SupportedOSPlatform("windows")>]
static member DeleteSetting : string * string * string -> unit

Public 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

SupportedOSPlatformAttribute

Excepciones

ArgumentException

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 .

Consulte también

• GetAllSettings(String, String)
• GetSetting(String, String, String, String)
• SaveSetting(String, String, String, String)
• ArgumentException