Position-Eigenschaft (ADO)

Gibt die aktuelle Position innerhalb eines Stream-Objekts an.

Einstellungen und Rückgabewerte

Legt einen Long-Wert fest, der den Offset der aktuellen Position bezogen auf den Anfang des Streams in Anzahl der Bytes angibt, oder gibt ihn zurück. Der Standardwert ist 0, was das erste Byte im Stream darstellt.

Bemerkungen

Die aktuelle Position kann an einen Punkt hinter dem Ende des Streams verschoben werden. Wenn Sie die aktuelle Position über das Ende des Streams hinaus angeben, wird die Size des Stream-Objekts entsprechend erhöht. Alle neuen Bytes, die auf diese Weise hinzugefügt werden, sind Null.

Hinweis

Position misst immer Bytes. Bei Textstreams mit Multibyte-Zeichensätzen multiplizieren Sie die Position mit der Zeichengröße, um die Anzahl der Zeichen zu ermitteln. Beispielsweise befindet sich bei einem Zwei-Byte-Zeichensatz das erste Zeichen an Position 0, das zweite Zeichen an Position 2, das dritte Zeichen an Position 4 usw.

Hinweis

Negative Werte können nicht verwendet werden, um die aktuelle Position in einem Stream zu ändern. Nur positive Zahlen können für Position verwendet werden.

Hinweis

Bei schreibgeschützten Stream-Objekten gibt ADO keinen Fehler zurück, wenn Position auf einen Wert festgelegt ist, der größer als Size des Streams ist. Dies ändert weder die Größe des Streams noch den Inhalt des Streams in irgendeiner Weise. Dies sollte jedoch vermieden werden, weil es zu einem sinnlosen Position-Wert führt.

Gilt für

Stream-Objekt (ADO)

Weitere Informationen

Charset-Eigenschaft (ADO)