DataRecordset.SetPrimaryKey 方法 (Visio)

會設定資料錄集的主索引鍵設定值及一個或多個主索引鍵資料欄名稱。

注意事項

This Visio object or member is available only to licensed users of Visio Professional 2013.

語法

運算式。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 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 支援與意見反應。