Описание
Задает или возвращает определяемое пользователем имя объекта доступа к данным (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