Функция GetAllSettings

Применяется к
Access для Microsoft 365 Access 2021 Access 2019 Access 2016

Примечание

Функция, метод, объект или свойство, описанные в данном разделе, отключаются, если служба обработки выражений Microsoft Jet выполняется в режиме песочницы, который не позволяет рассчитывать потенциально небезопасные выражения. Для получения дополнительных сведений выполните в справке поиск по словам "режим песочницы".

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

Синтаксис

GetAllSettings(appname, section)

Функция GetAllSettings имеет следующие аргументы:

Аргумент Описание
имя_приложения — обязательный аргумент. Строковое выражение, содержащее имя приложения или проекта, параметры ключа которого запрашиваются. На компьютерах Macintosh это имя файла инициализации в папке "Настройки" папки "Система".
раздел — обязательный аргумент. Строковое выражение , содержащее имя раздела, для которого запрашиваются параметры ключа. GetAllSettings возвращает объект Variant, содержимое которого представляет собой двумерный массив строк, содержащий все параметры ключа в указанном разделе и соответствующие им значения.

    

Замечания

GetAllSettings возвращает неинициализированный Variant , если имя приложения или раздел не существует.

Пример

Примечание

В примерах ниже показано, как использовать эту функцию в модуле Visual Basic для приложений (VBA). Чтобы получить дополнительные сведения о работе с VBA, выберите Справочник разработчика в раскрывающемся списке рядом с полем Поиск и введите одно или несколько слов в поле поиска.

В этом примере сначала используется инструкция SaveSetting для создания записей в реестре Windows для приложения, указанного в качестве appname, а затем используется функция GetAllSettings для отображения параметров. Обратите внимание, что имена приложений и разделов не могут быть получены с помощью GetAllSettings. После этого записи приложений удаляются с помощью функции DeleteSetting.

' Variant to hold 2-dimensional array returned by GetAllSettings
' Integer to hold counter.
Dim MySettings As Variant, intSettings As Integer
' Place some settings in the registry.
SaveSetting appname := "MyApp", section := "Startup", _
key := "Top", setting := 75
SaveSetting "MyApp","Startup", "Left", 50
' Retrieve the settings.
MySettings = GetAllSettings(appname := "MyApp", section := "Startup")
    For intSettings = LBound(MySettings, 1) To UBound(MySettings, 1)
        Debug.Print MySettings(intSettings, 0), MySettings(intSettings, 1)
    Next intSettings
DeleteSetting "MyApp", "Startup"