Метод DataRecordset.SetPrimaryKey (Visio)

Статья
04/07/2023

Задает значение параметра первичного ключа и имя столбца первичного ключа или столбцов для набора записей данных.

Примечание.

Этот объект или элемент Visio доступен только лицензированным пользователям Visio профессиональный 2013.

Синтаксис

expression. SetPrimaryKey (PrimaryKeySettings, PrimaryKey())

Выражение Выражение, возвращающее объект DataRecordset .

Параметры

Имя	Обязательный или необязательный	Тип данных	Описание
PrimaryKeySettings	Обязательный	VisPrimaryKeySettings	Параметр первичного ключа для набора записей данных. Возможные значения см. в разделе Примечания.
PrimaryKey()	Обязательный	[SAFE-ARRAY]	Массив переменных String .

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

Отсутствует

Примечания

Используйте метод SetPrimaryKey , чтобы указать параметр первичного ключа и имя столбца или столбца первичного ключа для набора записей данных. Параметр первичного ключа для набора записей данных указывается путем передачи значения из перечисления VisPrimaryKeySettings для параметра PrimaryKeySettings. Значение по умолчанию (если не указать первичный ключ) — visKeyRowOrder, что означает, что Visio определяет строки набора записей данных по порядку строк.

Можно указать, что набор записей данных содержит один столбец или составной первичный ключ. Первичный ключ с одним столбцом основывается на идентификации строк на значениях в одном столбце. Составной первичный ключ использует несколько столбцов для уникальной идентификации строки. В этой таблице показаны возможные значения для PrimaryKeySettings.

Константа	Значение	Описание
visKeyRowOrder	1	Используйте порядок строк в качестве первичного ключа.
visKeySingle	2	Используйте один столбец в качестве первичного ключевого столбца.
visKeyComposite	3	Используйте несколько столбцов в качестве первичных ключевых столбцов.

Для параметра PrimaryKey() передайте массив из одной или нескольких строк, представляющих имя столбца или столбцов, которые необходимо задать в качестве первичных ключевых столбцов. Значение, передаваемое для параметра PrimaryKeySettings, должно соответствовать количеству элементов массива. При установке первичных ключей убедитесь, что столбец или столбцы, выбранные как столбцы первичного ключа, содержат уникальные значения (или наборы значений) для каждой строки.

Используйте метод GetPrimaryKey , чтобы определить текущий параметр первичного ключа для набора записей данных, а также имя столбца или столбцов (если таковые имеются), которые в настоящее время заданы в качестве столбца или столбца первичного ключа.

Пример

В этом макросе Microsoft Visual Basic для приложений (VBA) показано, как можно использовать метод SetPrimaryKey для указания параметра первичного ключа для набора записей данных, а также имени столбца первичного ключа. Макрос находит последний созданный набор записей данных, связанный с документом, задает параметр первичного ключа (visKeySingle, чтобы указать первичный ключ из одного столбца) и задает имя столбца первичного ключа.

Перед выполнением этого макроса создайте по крайней мере один набор записей данных в текущем документе и замените переменную columnName в коде именем столбца в наборе записей данных, который необходимо указать в качестве столбца первичного ключа.

Public Sub SetPrimaryKey_Example() 
 
    Dim vsoDataRecordset As Visio.DataRecordset 
    Dim intCount As Integer 
    Dim aPrimaryKeyColumns() As String 
     
    intCount = ThisDocument.DataRecordsets.Count 
    aPrimaryKeyColumns(0) = "columnName " 
    Set vsoDataRecordset = ThisDocument.DataRecordsets(intCount) 
    vsoDataRecordset.SetPrimaryKey visKeySingle, aPrimaryKeyColumns 
    
End Sub

Поддержка и обратная связь

Есть вопросы или отзывы, касающиеся Office VBA или этой статьи? Руководство по другим способам получения поддержки и отправки отзывов см. в статье Поддержка Office VBA и обратная связь.

Поделиться через