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

Definición

Espacio de nombres:

Microsoft.VisualBasic

Ensamblado:

Microsoft.VisualBasic.Core.dll

Source:

Interaction.vb

Devuelve un valor de 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 GetAllSettings. Para obtener más información, consulte Registry.

[System.Runtime.Versioning.SupportedOSPlatform("windows")]
public static string? GetSetting (string AppName, string Section, string Key, string? Default = "");

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

Public Function GetSetting (AppName As String, Section As String, Key As String, Optional Default As String = "") As String

Parámetros

AppName

String

Obligatorio. String expresión que contiene el nombre de la aplicación o proyecto cuya configuración de clave se solicita.

Section

String

Obligatorio. String expresión que contiene el nombre de la sección en la que se encuentra la configuración de clave.

Key

String

Obligatorio. String expresión que contiene el nombre de la configuración de clave que se va a devolver.

Default

String

Opcional. Expresión que contiene el valor que se va a devolver si no se establece ningún valor en la configuración de Key. Si se omite, se supone que Default es una cadena de longitud cero ("").

Devoluciones

String

Valor de 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 GetAllSettings.

Atributos

SupportedOSPlatformAttribute

Excepciones

ArgumentException

Uno o varios argumentos no son expresiones String o el usuario no ha iniciado sesión.

Ejemplos

En este ejemplo se usa primero la función SaveSetting para realizar entradas en el Registro de Windows para la aplicación especificada como AppNamey, a continuación, se usa la función GetSetting para mostrar una de las opciones de configuración. Dado que se especifica el argumento Default, se garantiza que se devuelva algún valor. Tenga en cuenta que los nombres de Section no se pueden recuperar con GetSetting. Por último, la función DeleteSetting quita todas las entradas de la aplicación.

' Place some settings in the registry.
SaveSetting("MyApp", "Startup", "Top", "75")
SaveSetting("MyApp", "Startup", "Left", "50")
Console.WriteLine(GetSetting("MyApp", "Startup", "Left", "25"))
DeleteSetting("MyApp")

Comentarios

Si alguno de los elementos denominados en los argumentos de GetSetting no existe, GetSetting devuelve un valor de Default.

Dado que funciona con la clave del Registro de HKEY_LOCAL_USER, que no está activa hasta que un usuario inicia sesión de forma interactiva, GetSetting requiere que un usuario inicie sesión.

La configuración del Registro a la que se va a acceder desde un proceso no interactivo (por ejemplo, Mtx.exe) debe almacenarse en la HKEY_LOCAL_MACHINE\Software\ o en las claves del Registro de HKEY_USER\DEFAULT\Software.

GetSetting requiere ReadRegistryPermission.

Consulte también

• DeleteSetting(String, String, String)
• GetAllSettings(String, String)
• SaveSetting(String, String, String, String)
• ArgumentException
• RegistryPermission
• leer y escribir en el Registro (Visual Basic)