Freigeben über


DataRecordsets.GetLastDataError-Methode (Visio)

Ruft den ADO-Fehlercode (Active X-Datenobjekte), die ADO-Beschreibung und die ID des Datenrecordsets für einen Fehler ab, der beim Hinzufügen eines neuen Datenrecordsets oder beim Aktualisieren der Daten in einem vorhandenen Datenrecordset auftritt.

Hinweis

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

Syntax

Ausdruck. GetLastDataError (DataErrorCode, DataErrorDescription, RecordsetID)

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

Parameter

Name Erforderlich/Optional Datentyp Beschreibung
DataErrorCode Erforderlich Long Ausgabeparameter. Der ADO-Fehlercode des letzten Fehlers.
DataErrorDescription Erforderlich String Ausgabeparameter. Die ADO-Beschreibung des letzten Fehlers.
RecordsetID Erforderlich Long Ausgabeparameter. Die ID des Datenrecordsets, das den Fehler generiert oder ausgelöst hat.

Rückgabewert

Nichts

Bemerkungen

Zu den datenbezogenen Vorgängen, die ADO-Fehler in Microsoft Visio auslösen können, gehören das Hinzufügen eines neuen DataRecordset-Objekts in der DataRecordsets-Auflistung des aktiven Dokuments und das Aktualisieren der Daten in einem vorhandenen Datenrecordset.

Wenn ein datenbezogener Vorgang erfolgreich ist, gibt die GetLastDataError-Methode RecordsetID = 0, DataErrorCode = 0 und DataErrorDescription = "" (eine leere Zeichenfolge) zurück.

Wenn beim Versuch, ein Datenrecordset hinzuzufügen, ein Fehler generiert wird, gibt die Methode RecordsetID = 0 sowie den Fehlercode und die Beschreibung zurück.

Wenn der Versuch, die Daten in einem vorhandenen Datenrecordset zu aktualisieren, einen Fehler verursacht und wenn Visio erkennen kann, welches Datenrecordset den Fehler verursacht hat, gibt GetLastDataError die ID des Datenrecordsets zurück.

Es ist jedoch möglich, dass Visio nicht genau erkennen kann, welches Datenrecordset den Fehler verursacht hat. Dies kann nur geschehen, wenn Sie versuchen, ein Datenrecordset zu aktualisieren, das zu einer Gruppe von Datenrecordsets gehört, die dieselbe Verbindung mit einer Datenquelle verwenden. Der Grund dafür besteht darin, dass beim Aktualisieren von Daten in einem Datenrecordset einer solchen Gruppe (Transact-Datenrecordsets genannt) alle Datenrecordsets in der Gruppe aktualisiert werden. Wenn in diesem Fall der Aktualisierungsvorgang fehlschlägt, bevor alle Datarecordsets in der Gruppe aktualisiert werden, führt Visio ein Rollback für die Aktualisierung aller Bis zu diesem Zeitpunkt erfolgreich abgeschlossenen Datarecordsets durch.

Wenn Sie anschließend GetLastDataError aufrufen, gibt die Methode Folgendes zurück:

  • Die ID des Datenrecordsets, für das die Refresh-Methode zum Starten des Aktualisierungsvorgangs aufgerufen wurde, der anschließend einen Fehler verursacht hat.

  • Die durch den fehlgeschlagenen Aktualisierungsvorgang generierte Fehlermeldung, wobei jedoch nicht ermittelt werden kann, ob sich der Fehler tatsächlich auf das Datenrecordset bezogen hat, dessen ID an die GetLastDataError-Methode übergeben wurde.

Beispiel

Das folgende VBA-Makro (Microsoft Visual Basic für Applikationen) veranschaulicht, wie Sie mit der GetLastDataError-Methode den ADO-Fehlercode, die ADO-Beschreibung und die Datenrecordset-ID für den letzten Datenfehler abrufen.

Public Sub GetLastDataError_Example() 
 
    Dim vsoDataRecordsets As Visio.DataRecordsets 
    Dim lngCode As Long 
    Dim strDescription As String 
    Dim lngID As Long 
     
    Set vsoDataRecordsets = Visio.ActiveDocument.DataRecordsets 
     
    vsoDataRecordsets.GetLastDataError lngCode, strDescription, lngID 
     
    Debug.Print "Error code: ", lngCode 
    Debug.Print "Error description: ", strDescription 
    Debug.Print "Data recordset ID: ", lngID 
 
 
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.