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 de la entrada de una aplicación en el registro de Windows. La My característica proporciona mayor productividad y rendimiento en las operaciones del Registro que GetAllSettings. Para obtener más información, consulte Registry.
public static string GetSetting(string AppName, string Section, string Key, string Default = "");static member GetSetting : string * string * string * string -> stringPublic Function GetSetting (AppName As String, Section As String, Key As String, Optional Default As String = "") As StringParámetros
- AppName
- String
Required.
String expresión que contiene el nombre de la aplicación o proyecto cuya configuración de clave se solicita.
- Section
- String
Required.
String expresión que contiene el nombre de la sección en la que se encuentra la configuración de clave.
- Key
- String
Required.
String expresión que contiene el nombre de la configuración de clave que se va a devolver.
- Default
- String
Optional. Expresión que contiene el valor que se va a devolver si no se establece ningún valor en la Key configuración. Si se omite, Default se supone que es una cadena de longitud cero ("").
Devoluciones
Valor de configuración de clave de la entrada de una aplicación en el registro de Windows.
La My característica proporciona mayor productividad y rendimiento en las operaciones del Registro que GetAllSettings.
Excepciones
Uno o varios argumentos no String son expresiones 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 AppName y, a continuación, se usa la función GetSetting para mostrar una de las opciones de configuración. Dado que se especifica el Default argumento, se garantiza que se devuelva algún valor. Observe 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 claves del HKEY_LOCAL_MACHINE\Software\ Registro o HKEY_USER\DEFAULT\Software .
GetSetting requiere ReadRegistryPermission.