Interaction.GetAllSettings(String, String) Метод

Определение

Пространство имен:

Microsoft.VisualBasic

Сборка:

Microsoft.VisualBasic.Core.dll

Исходный код:

Interaction.vb

Возвращает список параметров разделов и соответствующих значений (первоначально созданных с помощью функции 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);

[<System.Runtime.Versioning.SupportedOSPlatform("windows")>]
static member GetAllSettings : string * string -> string[,]

Public Function GetAllSettings (AppName As String, Section As String) As String(,)

Параметры

AppName

String

Обязательный. Выражение типа String, содержащее имя приложения или проекта, для которого запрашиваются настройки параметров.

Section

String

Обязательный. Выражение String, содержащее имя раздела, параметры которого запрашиваются. Функция GetAllSettings возвращает объект, содержащий двухмерный массив строк. Строки содержат все настройки параметров в указанном разделе плюс соответствующие значения.

Возвращаемое значение

String[,]

Список параметров разделов и соответствующих значений (первоначально созданных с помощью функции SaveSetting) из записи приложения в реестре Windows.

Использование возможности My предоставляет большие производительность и быстродействие в операциях файлового ввода-вывода, чем GetAllSettings. Для получения дополнительной информации см. Registry.

Атрибуты

SupportedOSPlatformAttribute

Исключения

ArgumentException

Пользователь не выполнил вход в систему.

Примеры

В этом примере сначала используется 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 реестра или .

См. также раздел

• DeleteSetting(String, String, String)
• GetSetting(String, String, String, String)
• SaveSetting(String, String, String, String)
• ArgumentException
• Чтение данных из реестра и запись в реестр (Visual Basic)