TsgcWebSocketClient › Ereignisse › OnFragmented
Wird für jedes empfangene Fragment ausgelöst, wenn Options.FragmentedMessages frgAll oder frgOnlyFragmented ist.
property OnFragmented: TsgcWSFragmentedEvent;
// TsgcWSFragmentedEvent = procedure(Connection: TsgcWSConnection; const Data: TMemoryStream; const OpCode: TOpCode; const Continuation: Boolean) of object—
Standardmäßig (Options.FragmentedMessages = frgOnlyBuffer) puffert der Client die Fragmente einer Nachricht und löst OnMessage oder OnBinary aus, sobald die vollständigen Nutzdaten empfangen wurden. Setzen Sie die Eigenschaft auf frgOnlyFragmented, um nur OnFragmented pro Fragment zu empfangen, oder auf frgAll, um OnFragmented pro Fragment und anschließend OnMessage/OnBinary zu empfangen, wenn die Nachricht vollständig ist. Der Data-Parameter ist ein TMemoryStream mit den Bytes des aktuellen Fragments, OpCode gibt den ursprünglichen Frame-Typ an (Text, Binär, Continuation...), und Continuation ist True, solange weitere Fragmente erwartet werden, und False beim letzten Fragment. Dieses Ereignis ist nützlich, um den Fortschritt großer Streams zu melden.
procedure OnFragmented(Connection: TsgcWSConnection; const Data: TMemoryStream;
const OpCode: TOpCode; const Continuation: Boolean);
begin
ShowProgress(Data.Size);
if not Continuation then
SaveStream(Data);
end;