CopyTo-Methode (ADO)
Gilt für: Access 2013, Office 2013
Kopiert die angegebene Anzahl von Zeichen oder Bytes (in Abhängigkeit vom Type) von einem Stream-Objekt in ein anderes Stream-Objekt.
Syntax
Stream. CopyTo DestStream, NumChars
Parameter
| Parameter | Beschreibung |
|---|---|
| DestStream | Der Wert einer Objektvariable, der einen Verweis auf ein geöffnetes Stream -Objekt enthält. Das aktuelle Stream-Objekt wird in das durch DestStream angegebene Stream-Zielobjekt kopiert. Das Stream-Zielobjekt muss bereits geöffnet sein. Ist dies nicht der Fall, tritt ein Laufzeitfehler auf. HINWEIS: Der DestStream-Parameter ist möglicherweise kein Proxy des Stream-Objekts, da dies Zugriff auf eine private Schnittstelle auf dem Stream -Objekt erfordert, die nicht per Remotezugriff auf den Client übertragen werden kann. |
| NumChars | Optional. Ein Integer-Wert, der die Anzahl der Bytes oder Zeichen angibt, die von der aktuellen Position im Quell-Stream in den Ziel-Stream kopiert werden sollen. Der Standardwert ist –1, der angibt, dass alle Zeichen oder Bytes von der aktuellen Position nach EOS kopiert werden. |
Hinweise
This method copies the specified number of characters or bytes, starting from the current position specified by the Position property. If the specified number is more than the available number of bytes until EOS, then only characters or bytes from the current position to EOS are copied. Wenn der Wert von NumChars –1 ist oder ausgelassen wird, werden alle Zeichen oder Bytes, die von der aktuellen Position aus beginnen, kopiert.
Wenn der Zieldatenstrom bereits Zeichen oder Bytes enthält, bleibt der gesamte Inhalt nach dem Punkt, an dem die Kopie endet, erhalten und wird nicht abgeschnitten. Position beginnt bei dem Byte, dass unmittelbar auf das letzte kopierte Byte folgt. Wenn Sie diese Bytes abschneiden möchten, rufen Sie SetEOS auf.
CopyTo sollte verwendet werden, um Daten in ein Stream-Zielobjekt zu kopieren, das denselben Typ wie das Stream-Quellobjekt aufweist (ihre Type-Eigenschaften sind jeweils auf adTypeText oder auf adTypeBinary festgelegt). Bei Stream-Textobjekten können Sie die Einstellung der Charset-Eigenschaft für das Stream-Zielobjekt so ändern, dass ein Datensatz in einen anderen übertragen wird. Stream -Textobjekte können auch in binäre Stream -Objekte kopiert werden, aber binäre Stream -Objekte können nicht in Stream -Textobjekte kopiert werden.