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
объект , если или AppName
Section
не существует.
Так как он работает в HKEY_LOCAL_USER
разделе реестра, который не активен, пока пользователь не войдет в систему в интерактивном режиме, GetAllSettings
требуется, чтобы пользователь выполнил вход в систему.
Параметры реестра, доступ к которым требуется получить из неинтерактивного процесса (например, Mtx.exe), должны храниться в HKEY_LOCAL_MACHINE\Software\
разделах HKEY_USER\DEFAULT\Software
реестра или .