Share via


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

Definición

Devuelve un valor de configuración de clave desde 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, vea Registry.

[System.Runtime.Versioning.SupportedOSPlatform("windows")]
public static string? GetSetting (string AppName, string Section, string Key, string? Default = "");
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
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. Expresión de tipo String que contiene el nombre de la aplicación o del proyecto cuyo valor de clave se solicita.

Section
String

Obligatorio. Expresión de tipo String que contiene el nombre de la sección donde se encuentra la configuración de clave.

Key
String

Obligatorio. Expresión de tipo String 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 ha establecido ningún valor en la configuración de Key. Si se omite, se supone que Default es una cadena de longitud cero ("").

Devoluciones

Valor de configuración de clave desde 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

Excepciones

Uno o más argumentos no son expresiones String o el usuario no ha iniciado la sesión.

Ejemplos

En este ejemplo se usa primero la SaveSetting función para realizar entradas en el Registro de Windows para la aplicación especificada como AppNamey, a continuación, se usa la GetSetting función para mostrar una de las opciones de configuración. Dado que se especifica el Default argumento , se garantiza que se devuelve algún valor. Tenga en cuenta que Section los nombres no se pueden recuperar con GetSetting. Por último, la DeleteSetting función 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 GetSetting argumentos no existe, GetSetting devuelve un valor de Default.

Dado que funciona con la clave del HKEY_LOCAL_USER Registro, 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 las HKEY_LOCAL_MACHINE\Software\ claves del Registro o HKEY_USER\DEFAULT\Software .

GetSetting requiere ReadRegistryPermission.

Se aplica a

Consulte también