DataRecordset.Name-Eigenschaft (Visio)

Ruft den Anzeigenamen des Datenrecordsets ab oder legt ihn fest. Lese-/Schreibzugriff.

Hinweis

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

Syntax

Ausdruck. Namen

Ausdruck Eine Variable, die ein DataRecordset-Objekt darstellt.

Rückgabewert

Zeichenfolge

HinwBemerkungeneise

Der Anzeigename eines DataRecordset-Objekts ist der Name, den Sie als Name-Parameter an die DataRecordsets.Add,DataRecordsets.AddFromConnectionFile- oder DataRecordsets.AddFromXML-Methode übergeben haben, als Sie das Datenrecordset zum ersten Mal erstellt haben. oder den Namen, den Sie anschließend durch Festlegen dieser Eigenschaft zugewiesen haben. Wenn Sie beim Erstellen eines Datenrecordsets keinen Namen zuweisen, weist Microsoft Visio einen Standardnamen zu, z. B. Sheet1 , der dem zugewiesenen Namen entspricht, wenn Sie Daten aus einer Microsoft Excel-Arbeitsmappe importieren.

Wenn Sie (im AddOptions-Parameter einer der Add-Methoden) angeben, dass das Fenster Externe Daten auf der Visio-Benutzeroberfläche angezeigt werden soll, wird der Anzeigename auf der Registerkarte des Fensters Externe Daten angezeigt, die dem Datenrecordset entspricht.

Der Name-Eigenschaftswert muss innerhalb eines bestimmten Dokuments eindeutig sein. Sie können nicht mehreren Datenrecordsets den gleichen Anzeigenamen zuweisen. Wenn Sie versuchen, den Name-Eigenschaftswert eines vorhandenen Datenrecordsets einem anderen Datenrecordset im selben Dokument zuzuweisen, schlägt die Zuweisung fehl. Wenn Sie einem Dokument mithilfe der Add-Methode ein neues Datenrecordset hinzufügen und der Add-Methode den Namen eines vorhandenen Datenrecordsets als Anzeigenamen übergeben, fügt Visio einen Bindestrich und eine Zahl (z. B. -1) an den Namen an, um ihn innerhalb des Kontexts des Dokuments eindeutig zu machen.

Wenn Sie jedoch ein Datenrecordset löschen, können Sie den Anzeigenamen des gelöschten Datenrecordsets für ein anderes Datenrecordset in demselben Dokument verwenden. Dies ist im Gegensatz zum Fall des DataRecordset.ID Eigenschaftswerts. Eine bestimmte ID ist für die Lebensdauer des Dokuments eindeutig, und Sie können sie nicht wiederverwenden, auch wenn Sie das Datenrecordset löschen, dem sie zugewiesen wurde.

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.