DataRecordset.SetPrimaryKey 方法 (Visio)

设置数据记录集的主关键字设置值和主关键字列的名称。

注意

此 Visio 对象或成员仅供 Visio Professional 2013 的授权用户使用。

语法

表达式。SetPrimaryKey (PrimaryKeySettings， PrimaryKey () )

表达 返回 DataRecordset 对象的表达式。

参数

名称	必需/可选	数据类型	说明
PrimaryKeySettings	必需	VisPrimaryKeySettings	数据记录集的主关键字设置。 请参阅“注解”来了解可能的值。
PrimaryKey ()	必需	[SAFE-ARRAY]	String 类型的变量组成的数组。

返回值

Nothing

注解

使用 SetPrimaryKey 方法可指定数据记录集的主键设置和主键列的名称。 为数据记录集指定主关键字设置的方法是为 PrimaryKeySettings 参数传递 VisPrimaryKeySettings 枚举中的值。 默认值（不指定主关键字时）是 visKeyRowOrder，这表明 Visio 按行顺序标识数据记录集行。

可以指定数据记录集具有单列或复合主键。 单列主关键字根据单个列中的值标识行。 复合主键使用两个或多个列唯一地标识一行。 下表列出了 PrimaryKeySettings 的可能值。

常量	值	Description
visKeyRowOrder	1	使用行顺序作为主关键字。
visKeySingle	2	使用单个列作为主关键字列。
visKeyComposite	3	使用多个列作为主关键字列。

对于 PrimaryKey () 参数，传递一个或多个字符串的数组，这些字符串表示要设置为主键列 () 列的名称。 为 PrimaryKeySettings 参数传递的值必须与数组的项数一致。 在设置主关键字时，请确保要选作主关键字列的列在每一行中都包含唯一值（或值集）。

使用 GetPrimaryKey 方法确定数据记录集的当前主键设置，以及当前设置为主键列的列或列的名称（如果有）。

示例

此 Microsoft Visual Basic for Applications (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 支持和反馈，获取有关如何接收支持和提供反馈的指南。