Condividi tramite

Metodo CopyTo (ADO)

  • Articolo

Copia il numero specificato di caratteri o byte (a seconda di Type) nell'oggetto Stream in un altro oggetto Stream.

Sintassi

  
Stream.CopyTo DestStream, NumChars

Parametri

DestStream
Valore della variabile oggetto contenente un riferimento a un oggetto Stream aperto. L'oggetto Stream corrente viene copiato nell'oggetto Stream di destinazione specificato da DestStream. L'oggetto Stream di destinazione deve essere già aperto. In caso contrario, viene generato un errore di run-time.

Nota

Il parametro DestStream potrebbe non essere un proxy dell'oggetto Stream perché richiede l'accesso a un'interfaccia privata nell'oggetto Stream che non può essere usato in remoto per il client.

NumChars
facoltativo. Valore Integer che specifica il numero di byte o caratteri da copiare dalla posizione corrente nell'oggetto Stream di origine all'oggetto Stream di destinazione. Il valore predefinito è -1, che specifica che tutti i caratteri o i byte vengono copiati dalla posizione corrente a EOS.

Osservazioni

Questo metodo copia il numero specificato di caratteri o byte, a partire dalla posizione corrente specificata dalla proprietà Position. Se il numero specificato è maggiore del numero disponibile di byte fino a EOS, vengono copiati solo caratteri o byte dalla posizione corrente fino a quella definita da EOS. Se il valore di NumChars è -1 o omesso, vengono copiati tutti i caratteri o i byte a partire dalla posizione corrente.

Se nel flusso di destinazione sono presenti caratteri o byte esistenti, tutto il contenuto oltre il punto finale della copia rimane e non viene troncato. Position diventa il byte immediatamente successivo all'ultimo byte copiato. Per troncare questi byte, chiamare SetEOS.

È consigliabile usare CopyTo per copiare in dati in un oggetto Stream di destinazione dello stesso tipo dell'oggetto Stream di origine (le impostazioni della proprietà Type sono adTypeText o adTypeBinary per entrambi gli oggetti). Per gli oggetti Stream di testo è possibile modificare l'impostazione della proprietà Charset dell'oggetto Stream di destinazione per eseguire la conversione da un set di caratteri a un altro. Inoltre, gli oggetti Stream di testo possono essere copiati correttamente in oggetti Stream binari, mentre gli oggetti Stream binari non possono essere copiati in oggetti Stream di testo.

Si applica a

Oggetto Stream (ADO)