Reshape Name – dynamische Eigenschaft (ADO)

Gibt einen Namen für das Recordset-Objekt an.

Rückgabewerte

Gibt einen String-Wert zurück, der dem Namen des Recordsets entspricht.

Bemerkungen

Namen werden für die Dauer der Verbindung beibehalten oder bis das Recordset geschlossen wird.

Die Eigenschaft Reshape Name dient in erster Linie der Verwendung mit dem Umformfeature des Dienstanbieters Microsoft Data Shaping Service für OLE DB. Für die Umformung müssen Namen eindeutig sein.

Diese Eigenschaft ist schreibgeschützt, kann beim Erstellen eines Recordsets jedoch indirekt festgelegt werden. Wenn beispielsweise durch eine Klausel eines Shape-Befehls ein Recordset erstellt und mit dem AS-Schlüsselwort ein Alias zugewiesen wird, wird der Alias der Reshape Name-Eigenschaft zugewiesen. Wenn kein Alias deklariert wird, wird der Reshape Name-Eigenschaft ein eindeutiger Name zugewiesen, der vom Data Shaping Service generiert wird. Wenn der Aliasname mit dem Namen eines vorhandenen Recordsets identisch ist, kann keins der beiden Recordsets umgeformt werden. Eine Umformung ist in diesem Fall erst dann möglich, wenn ein Recordset freigegeben wird. Das Standardverhalten kann geändert werden, indem Sie einen eindeutigen Namen in der Reshape Name-Eigenschaft für die ADO-Verbindung auf True festlegen. Wenn Sie diese Eigenschaft festlegen, ist der Data Shaping Service berechtigt, den zugewiesenen Benutzernamen bei Bedarf zu ändern, um Eindeutigkeit sicherzustellen. Weitere Informationen zum Neuformen finden Sie unter Microsoft Data Shaping Service für OLE DB (ADO-Dienstanbieter).

Verwenden Sie die Reshape Name-Eigenschaft, wenn Sie in einem Shape-Befehl auf ein Recordset verweisen möchten, oder wenn Sie den Namen nicht kennen, weil er vom Data Shaping Service generiert wurde. In diesem Fall können Sie einen SHAPE-Befehl generieren, indem Sie den Befehl um die Zeichenfolge verketten, die von der Reshape Name-Eigenschaft zurückgegeben wird.

Reshape Name ist eine dynamische Eigenschaft, die an die Properties-Auflistung des Recordset-Objekts angefügt wird, wenn die CursorLocation-Eigenschaft auf adUseClient festgelegt ist.

Gilt für

Recordset-Objekt (ADO)

Weitere Informationen

Microsoft Data Shaping Service für OLE DB (ADO-Dienstanbieter)
Shape-Befehle im Allgemeinen
Recordset-Objekt (ADO)