Interaction.GetAllSettings(String, String) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает список параметров ключа и их соответствующих значений (первоначально созданных с помощью SaveSetting) из записи приложения в реестре Windows.
My Использование этой функции обеспечивает большую производительность и производительность в операциях реестра, чем GetAllSettings. Дополнительные сведения см. в разделе 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(,)Параметры
- AppName
- String
Обязательно.
String выражение, содержащее имя приложения или проекта, параметры ключа которого запрашиваются.
- Section
- String
Обязательно.
String выражение, содержащее имя раздела, параметры ключа которого запрашиваются.
GetAllSettings возвращает объект, содержащий двухмерный массив строк. Строки содержат все параметры ключа в указанном разделе, а также соответствующие значения.
Возвращаемое значение
Список параметров ключа и их соответствующих значений (первоначально созданных с помощью SaveSetting) из записи приложения в реестре Windows.
My Использование этой функции обеспечивает большую производительность и производительность в операциях реестра, чем GetAllSettings. Дополнительные сведения см. в разделе Registry.
- Атрибуты
Исключения
Пользователь не входит в систему.
Примеры
В этом примере сначала используется функция SaveSetting для записи в реестре Windows для приложения, указанного как AppName, а затем использует функцию GetAllSettings для отображения параметров. Обратите внимание, что имена и Section имена приложений нельзя извлечь с GetAllSettingsпомощью . Наконец, DeleteSetting функция удаляет записи приложения.
' 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")
Комментарии
GetAllSettings возвращает неинициализированную Object , если AppNameSection она не существует.
Так как он работает под разделом HKEY_LOCAL_USER реестра, который не активен, пока пользователь не войдет в систему в интерактивном режиме, GetAllSettings требует, чтобы пользователь вошел в систему.
Параметры реестра, к которым необходимо получить доступ из неинтерактивного процесса (например, Mtx.exe) должны храниться в HKEY_LOCAL_MACHINE\Software\ разделах реестра или в HKEY_USER\DEFAULT\Software разделах реестра.
