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 la configuración de clave y sus respectivos valores (creados originalmente con SaveSetting) desde la entrada de una aplicación en el registro de Windows. El uso de 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 cli::array <System::String ^, 2> ^ GetAllSettings(System::String ^ AppName, System::String ^ Section);public static string[,] GetAllSettings(string AppName, string Section);static member GetAllSettings : string * string -> string[,]Public Function GetAllSettings (AppName As String, Section As String) As String(,)Pará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 cuya configuración de clave se solicita.
GetAllSettings devuelve un objeto que contiene una matriz bidimensional de cadenas. Las cadenas contienen toda la configuración de clave de la sección especificada, además de sus valores correspondientes.
Devoluciones
Lista de la configuración de clave y sus respectivos valores (creados originalmente con SaveSetting) a partir de la entrada de una aplicación en el registro de Windows.
El uso de la My característica proporciona mayor productividad y rendimiento en las operaciones del Registro que GetAllSettings. Para obtener más información, consulte Registry.
Excepciones
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 GetAllSettings para mostrar la configuración. Tenga en cuenta que los nombres y Section 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 valor sin inicializar Object si existe AppName o Section no.
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 claves del HKEY_LOCAL_MACHINE\Software\ Registro o HKEY_USER\DEFAULT\Software .