DataRecordset.SetPrimaryKey method (Visio)

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

注意事項

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

語法

表情。SetPrimaryKey (PrimaryKeySettings， PrimaryKey () )

詞 一個回傳 DataRecordset 物件的表達式。

參數

名稱	必要/選用	資料類型	描述
PrimaryKeySettings	必要	VisPrimaryKeySettings	資料錄集的主索引鍵設定。 如需可能的值，請參閱＜備註＞。
主鑰匙 ()	必要	[保險陣]	String 變數陣列。

傳回值

無

註解

使用 SetPrimaryKey 方法指定資料集中的主鍵設定及主鍵欄位名稱。 藉由從 VisPrimaryKeySettings 列舉傳遞 PrimaryKeySettings 參數的值，可以指定資料錄集的主索引鍵設定。 (當您沒有指定主索引鍵時) 預設值是 visKeyRowOrder，表示 Visio 會依照資料列順序來識別資料錄集資料列。

你可以指定資料記錄集的主鍵是單欄或複合鍵。 單一資料欄主索引鍵會根據單一資料欄中的值來識別資料列。 綜合主索引鍵會使用兩個以上的資料欄來唯一識別資料列。 下表顯示 PrimaryKeySettings 的可能值。

常數	值	描述
visKeyRow 順序	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 支援與意見反應。