CopyTo-Methode (ADO)
Kopiert die angegebene Anzahl von Zeichen oder Bytes (je nach Type) in das Stream- in ein anderes Stream-Objekt.
Syntax
Stream.CopyTo DestStream, NumChars
Parameter
DestStream-
Ein Objektvariablenwert, der einen Verweis auf ein geöffnetes Stream-Objekt enthält. Das aktuelle Stream- wird in das Ziel Stream kopiert, das von DestStream-angegeben wird. Das Ziel Stream- muss bereits geöffnet sein. Wenn dies nicht der Fall ist, tritt ein Laufzeitfehler auf.
Anmerkung
Der DestStream Parameter ist möglicherweise kein Proxy Stream Objekts, da dies Zugriff auf eine private Schnittstelle auf dem Stream-Objekt erfordert, das nicht an den Client entfernt werden kann.
NumChars-
Wahlfrei. Ein Integer Wert, der die Anzahl der Bytes oder Zeichen angibt, die von der aktuellen Position in der Quelle Stream an das Ziel Streamkopiert werden sollen. Der Standardwert ist -1, der angibt, dass alle Zeichen oder Bytes von der aktuellen Position in EOSkopiert werden.
Bemerkungen
Diese Methode kopiert die angegebene Anzahl von Zeichen oder Bytes, beginnend mit der aktuellen Position, die durch die Position-Eigenschaft angegeben ist. Wenn die angegebene Zahl mehr als die verfügbare Anzahl von Bytes ist, bis EOS, werden nur Zeichen oder Bytes von der aktuellen Position in EOS kopiert. Wenn der Wert von NumChars -1 oder ausgelassen ist, werden alle Zeichen oder Bytes, die von der aktuellen Position beginnen, kopiert.
Wenn im Zieldatenstrom vorhandene Zeichen oder Bytes vorhanden sind, bleiben alle Inhalte über den Punkt hinaus, an dem die Kopie endet, und werden nicht abgeschnitten. Position wird das Byte unmittelbar nach dem letzten kopierten Byte. Wenn Sie diese Bytes abschneiden möchten, rufen Sie SetEOS-auf.
CopyTo sollten verwendet werden, um Daten in ein Ziel Stream- desselben Typs wie die Quelle Stream zu kopieren (ihre Type-Eigenschaftseinstellungen sind beide adTypeText oder beide adTypeBinary). Für Text Stream-Objekte können Sie die Einstellung der Charset Eigenschaft des Ziels Stream- ändern, um von einem Zeichensatz in einen anderen zu übersetzen. Außerdem können Text Stream-Objekte erfolgreich in binäre Stream-Objekte kopiert werden, aber binäre Stream--Objekte können nicht in Text Stream--Objekte kopiert werden.