Interaction.GetAllSettings(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 una lista de configuraciones de clave y sus respectivos valores (creados originalmente con SaveSetting
) 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.
public:
static cli::array <System::String ^, 2> ^ GetAllSettings(System::String ^ AppName, System::String ^ Section);
[System.Runtime.Versioning.SupportedOSPlatform("windows")]
public static string[,]? GetAllSettings (string AppName, string Section);
public static string[,] GetAllSettings (string AppName, string Section);
[<System.Runtime.Versioning.SupportedOSPlatform("windows")>]
static member GetAllSettings : string * string -> string[,]
static member GetAllSettings : string * string -> string[,]
Public Function GetAllSettings (AppName As String, Section 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 cuya configuración de clave se solicita.
- Section
- String
Obligatorio. Expresión de tipo String
que contiene el nombre de la sección cuya configuración de clave se solicita. GetAllSettings
devuelve un objeto que contiene una matriz bidimensional de cadenas. Las cadenas contienen todos las configuraciones de clave de la sección especificada, además de sus correspondientes valores.
Devoluciones
Lista de configuraciones de clave y sus respectivos valores (creados originalmente con SaveSetting
) 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.
- Atributos
Excepciones
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 GetAllSettings
función para mostrar la configuración. Tenga en cuenta que los nombres y Section
los nombres de la aplicación no se pueden recuperar con GetAllSettings
. Por último, la DeleteSetting
función quita las entradas de la aplicación.
' Object to hold 2-dimensional array returned by GetAllSettings.
' Integer to hold counter.
Dim MySettings(,) As String
Dim intSettings As Integer
' Place some settings in the registry.
SaveSetting("MyApp", "Startup", "Top", "75")
SaveSetting("MyApp", "Startup", "Left", "50")
' Retrieve the settings.
MySettings = GetAllSettings("MyApp", "Startup")
For intSettings = LBound(MySettings, 1) To UBound(MySettings, 1)
WriteLine(1, MySettings(intSettings, 0))
WriteLine(1, MySettings(intSettings, 1))
Next intSettings
DeleteSetting("MyApp")
Comentarios
GetAllSettings
devuelve un inicializado Object
si o AppName
Section
no existe.
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, GetAllSettings
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
.