Freigeben über

Eigenschaftsobjekt (DAO)

  • Artikel

Gilt für: Access 2013, Office 2013

Ein Property-Objekt stellt eine integrierte oder benutzerdefinierte Eigenschaft eines DAO-Objekts dar.

Hinweise

Alle DAO-Objekte, außer den Objekten Connection und Error, enthalten eine Properties-Auflistung mit Property-Objekten, die den integrierten Eigenschaften dieses DAO-Objekts entsprechen. Der Benutzer kann außerdem Property-Objekte definieren und sie der Properties-Auflistung eines DAO-Objekts anfügen. Diese Property-Objekte (die häufig lediglich "Eigenschaften" genannt werden) kennzeichnen die betreffende Objektinstanz eindeutig.

Sie können für die folgenden Objekte benutzerdefinierte Eigenschaften erstellen:

  • Database-, Index-, QueryDef- und TableDef-Objekte

  • Field-Objekte in Fields-Auflistungen von QueryDef- und TableDef-Objekten

Um eine benutzerdefinierte Eigenschaft hinzuzufügen, verwenden Sie die CreateProperty-Methode, um ein Property-Objekt mit einer eindeutigen Name-Eigenschaftseinstellung zu erstellen. Legen Sie die Type - und Value-Eigenschaften des neuen Property-Objekts fest, und fügen Sie es dann an die Properties-Auflistung des entsprechenden Objekts an. Das Objekt, dem Sie die benutzerdefinierte Eigenschaft hinzufügen, muss bereits an eine Auflistung angefügt werden. Das Verweisen auf ein benutzerdefiniertes Property-Objekt , das noch nicht an eine Properties-Auflistung angefügt wurde, führt ebenso zu einem Fehler wie das Anfügen eines benutzerdefinierten Property-Objekts an eine Properties-Auflistung , die ein Property-Objekt mit demselben Namen enthält.

Sie können benutzerdefinierte Eigenschaften aus der Properties-Auflistung entfernen, integrierte Eigenschaften können jedoch nicht gelöscht werden.

Hinweis

[!HINWEIS] Ein benutzerdefiniertes Property-Objekt ist nur einer bestimmten Objektinstanz zugeordnet. Die Eigenschaft ist nicht für alle Objektinstanzen des ausgewählten Typs definiert.

Mithilfe der Properties-Auflistung eines Objekts können Sie dessen integrierte und benutzerdefinierte Eigenschaften auflisten. Zu diesem Zweck müssen Sie nicht genau wissen, welche Eigenschaften vorhanden sind oder mit welchen Merkmalen (Name- und Type-Eigenschaft) sie bearbeitet werden. Ein Fehler tritt jedoch auf, wenn Sie eine lesegeschützte Eigenschaft zu lesen versuchen (z. B. die Password-Eigenschaft eines Workspace-Objekts), oder wenn Sie versuchen, eine Eigenschaft in einem ungeeigneten Kontext zu lesen oder zu schreiben (z. B. die Einstellung der Value-Eigenschaft eines Field-Objekts in der Fields-Auflistung eines TableDef-Objekts).

Das Property-Objekt besitzt auch vier integrierte Eigenschaften:

  • Die Name-Eigenschaft mit einem String-Wert, der die Eigenschaft eindeutig identifiziert.

  • Die Type-Eigenschaft mit einem Integer-Wert, der den Datentyp der Eigenschaft angibt.

  • Die Value-Eigenschaft mit einem Variant-Wert, der die Einstellung der Eigenschaft enthält.

  • Die Inherited-Eigenschaft mit einem Boolean-Wert, der angibt, ob die Eigenschaft von einem anderen Objekt vererbt wurde. Ein Field-Objekt in einer Fields-Auflistung eines Recordset-Objekts kann z. B. Eigenschaften des zugrunde liegenden TableDef- oder QueryDef-Objekts erben.

Wenn Sie auf ein integriertes Property-Objekt in einer Auflistung mit seiner Ordnungszahl oder mit der Einstellung seiner Name-Eigenschaft verweisen möchten, verwenden Sie eine der folgenden Syntaxformen:

  • object**. Eigenschaften**(0)

  • object**. Eigenschaften**("name")

  • object**. Eigenschaften**! [Name]

Bei einer integrierten Eigenschaft können Sie auch diese Syntax verwenden:

  • -Objekt.Namen

Hinweis

Für eine benutzerdefinierte Eigenschaft müssen Sie das vollständige Objekt** verwenden. Eigenschaften**("Name")-Syntax.

Sie können mit denselben Syntaxformen auf die Value-Eigenschaft eines Property-Objekts verweisen. Der Kontext des Verweises entscheidet, ob Sie sich auf das Property-Objekt selbst oder auf die Value-Eigenschaft des Property-Objekts beziehen.