DataRecordset.SetPrimaryKey-Methode (Visio)

Legt den Wert der Primärschlüsseleinstellung und den Namen der Primärschlüsselspalten für das Datenrecordset fest.

Syntax

Ausdruck verwendet werden. SetPrimaryKey (PrimaryKeySettings, PrimaryKey())

Ausdruck Ein Ausdruck, der ein DataRecordset-Objekt zurückgibt.

Parameter

Rückgabewert

Nichts

Bemerkungen

Verwenden Sie die SetPrimaryKey-Methode , um die Primärschlüsseleinstellung und den Namen der Primärschlüsselspalte bzw. der Primärschlüsselspalten für das Datenrecordset anzugeben. Sie geben die Primärschlüsseleinstellung für das Datenrecordset an, indem Sie einen Wert aus der VisPrimaryKeySettings-Enumeration für den PrimaryKeySettings-Parameter übergeben. Der Standardwert (wenn Sie keinen Primärschlüssel angeben) ist visKeyRowOrder, d. h., dass Visio Datenrecordset-Zeilen nach Zeilenreihenfolge identifiziert.

Sie können angeben, dass die Datenrecordsets entweder einen einspaltigen oder einen zusammengesetzten Primärschlüssel haben. Bei Primärschlüsseln mit einer Spalte basiert die Zeilenidentifikation auf den Werten in einer einzelnen Spalte. Ein zusammengesetzter Primärschlüssel verwendet zwei oder mehr Spalten, um eine Zeile eindeutig zu ermitteln. Mögliche Werte für PrimaryKeySettings werden in dieser Tabelle angezeigt.

Übergeben Sie für den PrimaryKey()-Parameter ein Array mit einer oder mehreren Zeichenfolgen, die den Namen der Spalte oder Spalten darstellen, die Sie als Primärschlüsselspalte(n) festlegen möchten. Der als PrimaryKeySettings-Parameter übergebene Wert muss mit der Anzahl der Arrayelemente konsistent sein. Stellen Sie beim Festlegen von Primärschlüsseln sicher, dass die Spalten, die Sie als Primärschlüsselspalten auswählen, für jede Zeile eindeutige Werte (oder Wertsätze) enthalten.

Verwenden Sie die GetPrimaryKey-Methode , um die aktuelle Primärschlüsseleinstellung für das Datenrecordset sowie den Namen der Spalte oder Spalten (falls vorhanden) zu ermitteln, die derzeit als Primärschlüsselspalte oder -spalten festgelegt sind.

Beispiel

Dieses Microsoft Visual Basic for Applications (VBA)-Makro zeigt, wie Sie die SetPrimaryKey-Methode verwenden können, um die Primärschlüsseleinstellung für ein Datenrecordset sowie den Namen der Primärschlüsselspalte anzugeben. Das Makro sucht das zuletzt erstellte Datenrecordset, das mit dem Dokument verknüpft ist, gibt die Primärschlüsseleinstellung (visKeySingle, um einen einspaltigen Primärschlüssel anzugeben) und legt den Namen der Primärschlüsselspalte fest.

Erstellen Sie vor dem Ausführen dieses Makros mindestens ein Datenrecordset im aktuellen Dokument, und ersetzen Sie die Variable columnName im Code durch den Namen der Spalte im Datenrecordset, die als Primärschlüsselspalte angegeben werden soll.

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

Support und Feedback

Haben Sie Fragen oder Feedback zu Office VBA oder zu dieser Dokumentation? Unter Office VBA-Support und Feedback finden Sie Hilfestellung zu den Möglichkeiten, wie Sie Support erhalten und Feedback abgeben können.