DataRecordset.SetPrimaryKey-Methode (Visio)

Artikel
04/07/2023

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

Hinweis

Dieses Visio-Objekt oder dieses Visio-Mitglied ist nur für lizenzierte Benutzer von Visio Professional 2013 verfügbar.

Syntax

Ausdruck. SetPrimaryKey (PrimaryKeySettings, PrimaryKey())

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

Parameter

Name	Erforderlich/Optional	Datentyp	Beschreibung
PrimaryKeySettings	Erforderlich	VisPrimaryKeySettings	Die Primärschlüsseleinstellung für das Datenrecordset. Mögliche Werte finden Sie in den Hinweisen.
PrimaryKey()	Erforderlich	[SAFE-ARRAY]	Ein Array von String-Variablen.

Rückgabewert

Nichts

Bemerkungen

Verwenden Sie die SetPrimaryKey-Methode , um die Primärschlüsseleinstellung und den Namen der Primärschlüsselspalte oder -spalten 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. Dies bedeutet, dass Visio Datenrecordsetzeilen nach Zeilenreihenfolge identifiziert.

Sie können angeben, dass das Datenrecordset entweder über einen einspaltigen oder einen zusammengesetzten Primärschlüssel verfügt. 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.

Konstante	Wert	Beschreibung
visKeyRowOrder	1	Verwenden der Zeilenreihenfolge als Primärschlüssel
visKeySingle	2	Verwenden einer einzelnen Spalte als Primärschlüsselspalte
visKeyComposite	3	Verwenden mehrerer Spalten als Primärschlüsselspalten

Übergeben Sie für den PrimaryKey()-Parameter ein Array aus 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 ggf. den Namen der Spalte oder Spalten zu bestimmen, die derzeit als Primärschlüsselspalte oder -spalten festgelegt sind.

Beispiel

Dieses VBA-Makro (Microsoft Visual Basic for Applications) 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 nach dem zuletzt erstellten Datenrecordset, das dem Dokument zugeordnet ist, gibt die Primärschlüsseleinstellung an (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.

Freigeben über