Freigeben über

CopyTo-Methode (ADO)

  • Artikel

Kopiert die angegebene Anzahl von Zeichen oder Bytes (abhängig von Type) im Stream in ein anderes Stream-Objekt

Syntax

  
Stream.CopyTo DestStream, NumChars

Parameter

DestStream
Ein Objektvariablenwert, der einen Verweis auf ein offenes Stream-Objekt enthält. Der aktuelle Stream wird in den Ziel-Stream kopiert, der von DestStream angegeben wird. Der Ziel-Stream muss bereits geöffnet sein. Wenn dies noch nicht geschehen ist, tritt ein Laufzeitfehler auf.

Hinweis

Der Parameter DestStream ist möglicherweise kein Proxy des Stream-Objekts, da dieser Zugriff auf eine private Schnittstelle auf dem Stream-Objekt benötigt, das nicht remote mit dem Client verbunden werden kann.

NumChars
Optional. Ein Integer-Wert, der die Anzahl der Bytes oder Zeichen angibt, die aus der aktuellen Position im Quell-Stream in den Ziel-Stream kopiert werden sollen. Der Standardwert ist -1. Er gibt an, dass alle Zeichen oder Bytes aus der aktuellen Position zu EOS kopiert werden.

Bemerkungen

Mit dieser Methode wird die angegebene Anzahl von Zeichen oder Bytes kopiert, beginnend mit der aktuellen Position, die von der Position-Eigenschaft angegeben wird. Wenn die angegebene Zahl größer als die verfügbare Anzahl von Bytes bis EOS ist, werden nur Zeichen oder Bytes aus der aktuellen Position zu EOS kopiert. Wenn der Wert von NumChars -1 beträgt oder weggelassen wird, werden alle Zeichen oder Bytes ab der aktuellen Position kopiert.

Wenn im Zielstream Zeichen oder Bytes vorhanden sind, bleiben alle Inhalte über dem Punkt hinaus erhalten, an dem die Kopie endet, und werden nicht abgeschnitten. Position wird zu dem Byte, das auf das letzte kopierte Byte folgt. Wenn Sie diese Bytes abschneiden möchten, rufen Sie SetEOS auf.

CopyTo sollte verwendet werden, um Daten in einen Ziel-Stream desselben Typs wie den Quell-Stream zu kopieren. Ihre Type-Eigenschaftseinstellungen lauten sowohl adTypeText als auch adTypeBinary. Für Text-Stream-Objekte können Sie die Charset-Eigenschaftseinstellung des Ziel-Stream ändern, um von einem Zeichensatz in einen anderen zu verschieben. Außerdem können Text-Stream-Objekte in binäre Stream-Objekte kopiert werden, doch binäre Stream-Objekte können nicht in Text-Stream-Objekte kopiert werden.

Gilt für

Stream-Objekt (ADO)