System.Classes.TStream.CopyFrom

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

function CopyFrom(const Source: TStream; Count: Int64 = 0; BufferSize: Integer = $100000): Int64;

C++

__int64 __fastcall CopyFrom(TStream* const Source, __int64 Count = 0LL, int BufferSize = 0x100000);

Eigenschaften

Typ Sichtbarkeit Quelle Unit Übergeordnet
function public
System.Classes.pas
System.Classes.hpp
System.Classes TStream


Beschreibung

Kopiert die angegebene Anzahl Bytes aus einem Stream in einen anderen.

Verwenden Sie CopyFrom, um Daten aus einem Stream in einen anderen zu kopieren. Mit CopyFrom müssen Sie keinen Puffer erstellen, lesen, beschreiben und freigeben, um Daten zu kopieren.

CopyFrom kopiert die in Count angegebene Anzahl Bytes aus dem in Source angegebenen Stream in den Stream. Dann wird die aktuelle Position um die in Count angegebene Anzahl Bytes verschoben und die Anzahl der kopierten Bytes zurückgegeben.

Wenn Count 0 enthält, setzt CopyFrom vor dem Lesen die Position in Source auf 0 und kopiert dann den gesamten Inhalt von Source in den Stream. Wenn Count größer oder kleiner als 0 ist, liest CopyFrom ab der aktuellen Position in Source.

Weil die Methode CopyFrom mit ReadBuffer und WriteBuffer das Kopieren durchführt, löst ReadBuffer eine Exception aus, wenn Count größer als SourceStream ist. Die Exception gibt an, dass ein Stream-Lesefehler aufgetreten ist.

Siehe auch

Codebeispiele