Interaction.GetSetting(String, 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í.
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 AppName
y, 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 Read
RegistryPermission.
Se aplica a
Consulte también
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea:Enviar y ver comentarios de