System.Classes.TStream.CopyFrom
Delphi
function CopyFrom(const Source: TStream; Count: Int64): Int64;
C++
__int64 __fastcall CopyFrom(TStream* const Source, __int64 Count);
Inhaltsverzeichnis
Eigenschaften
Typ | Sichtbarkeit | Quelle | Unit | Übergeordnet |
---|---|---|---|---|
function | public | System.Classes.pas System.Classes.hpp |
System.Classes | TStream |
Beschreibung
Kopiert eine angegebene Anzahl von Bytes aus einem Stream in einen anderen.
Verwenden Sie CopyFrom , um die Daten aus einem Stream in einen anderen zu kopieren. Mit CopyFrom muss der Benutzer keinen Pufferspeicher erstellen, lesen, beschreiben und freigeben, um Daten zu kopieren.
CopyFrom kopiert die in Count angegebene Anzahl von Bytes aus dem in Source angegebenen Stream in den Stream. Dann wird die aktuelle Position um die in Count angegebene Anzahl von Bytes verschoben und die Anzahl der kopierten Bytes zurückgegeben.
Wenn Count 0 ist, setzt CopyFrom vor dem Lesen die Position in Source auf 0 und kopiert dann den gesamten Inhalt von Source in den Stream. Ist Count größer bzw. kleiner als 0, liest CopyFrom aus der aktuellen Position in Source lesen.
Weil die Methode CopyFrom mit ReadBuffer und WriteBuffer das Kopieren eigentlich durchführt, löst ReadBuffer eine Exception aus, wenn Count größer als die Größe des SourceStream ist. Die Exception gibt an, dass ein Stream-Lesefehler aufgetreten ist.