Описание
Задает или возвращает определяемое пользователем имя объекта доступа к данным (DAO). Для объекта, не добавленного в семейство, это свойство доступно для чтения/записи.
Значение
Задаваемое или возвращаемое значение является выражением типа String, указывающим имя объекта. Имя объекта должно начинаться с буквы. Максимальный размер (в символах) значения свойства Name определяется типом объекта, как показано в разделе "Дополнительные сведения". Имя может содержать цифры и символы подчеркивания ( _ ), но не должно содержать знаки препинания.
Замечания
Объект TableDef, QueryDef, Field, Index, User и Group не может иметь имя, совпадающее с именем другого объекта в том же семействе.
Значением свойства Name объекта Recordset, открытого с помощью инструкции SQL, становятся первые 256 символов инструкции SQL.
Допускается использование свойства Name в инструкциях Dim в программах Visual Basic для приложений (VBA) для создания новых экземпляров объекта.
Для многих объектов доступа к данным (DAO) свойство Name отражает имя, зарегистрированное в объекте Database. Это же относится к объектам TableDef, Field или QueryDef. Прямой связи между именем объекта и именем используемой для ссылок на объект базы данных объектной переменной не существует.
Использование для чтения/записи свойства Name при доступе к объекту определяется типом объекта, к которому относится свойство, а также тем, был ли объект добавлен в семейство. В рабочей области ODBCDirect свойство Name добавленного объекта всегда доступно только для чтения. В следующей таблице показано, в каких случаях свойство Name в рабочей области Microsoft Jet доступно для чтения записи или только для чтения для объекта, добавленного в семейство (если иное не указано). Для случая, когда свойство допускает чтение/запись, приведена максимальная длина значения (в символах).
Объект Применение Длина Container Только чтение Connection Только чтение Database Только чтение Document Только чтение Field Не добавлен Чтение/запись 64 Добавлен в Index Только чтение Добавлен в QueryDef Только чтение Добавлен в Recordset Только чтение Добавлен в TableDef (таблица в базе данных) Чтение/запись 64 Добавлен в TableDef (присоединенная таблица ) Только чтение Добавлен в Relation Только чтение Group Не добавлен Чтение/запись 20 Добавлено Только чтение Index Не добавлен Чтение/запись 64 Добавлено Только чтение Parameter Только чтение Property Не добавлен Чтение/запись 64 Добавлено Только чтение Встроенный Только чтение QueryDef Не добавлен Чтение/запись 64 Временный Только чтение Добавлено Чтение/запись 64 Recordset Только чтение Relation Не добавлен Чтение/запись 64 Добавлено Только чтение TableDef Чтение/запись 64 User Не добавлен Чтение/запись 20 Добавлено Только чтение Workspace Не добавлен Чтение/запись 20 Добавлено Только чтение
Пример
Следующая программа использует свойство Name для указания имени нового объекта, для вывода перечня объектов в семействе и для удаления объекта из семейства.
Sub NameX() Dim dbsNorthwind As Database Dim qdfNew As QueryDef Dim qdfLoop As QueryDef Set dbsNorthwind = OpenDatabase("Борей.mdb") With dbsNorthwind ' Создает новый постоянный объект QueryDef ' и добавляет его в семейство QueryDefs. Set qdfNew = .CreateQueryDef() qdfNew.Name = "NewQueryDef" qdfNew.SQL = "SELECT * FROM Сотрудники" .QueryDefs.Append qdfNew ' Отображает семейство имена объектов QueryDef ' в семействе QueryDefs. Debug.Print "Имена запросов в " & .Name For Each qdfLoop In .QueryDefs Debug.Print " " & qdfLoop.Name Next qdfLoop ' Удаляет новый объект QueryDef, созданный ' только для демонстрации. .QueryDefs.Delete qdfNew.Name .Close End With End Sub