Put Methode

Overload 1

Syntaxis

function Put(const aURL: string; const aSource: TStream): string;

Parameters

Naam	Type	Beschrijving
aURL	const string	Absolute URL die de resource identificeert die wordt aangemaakt of vervangen.
aSource	const TStream	Stream die de volledige representatie van de op te slaan resource levert.

Retourwaarde

Responsebody die van de server is ontvangen, gedecodeerd als een string. (string)

Opmerkingen

PUT is idempotent: herhaaldelijk aanroepen met dezelfde inhoud levert dezelfde resourcestatus op de server op. Deze overload is geschikt voor JSON/tekst-payloads waarvan de tekstuele respons als een tekenreeks kan worden verwerkt.

Voorbeeld

oBody := TStringStream.Create('{"status":"active"}');
try
  oClient.Request.ContentType := 'application/json';
  vResponse := oClient.Put('https://api.example.com/users/42', oBody);
finally
  oBody.Free;
end;

Overload 2

Syntaxis

procedure Put(const aURL: string; const aSource: TStream; const aResponseContent: TStream);

Parameters

Naam	Type	Beschrijving
aURL	const string	Absolute URL die de te maken of te vervangen resource identificeert.
aSource	const TStream	Stream die de te uploaden resourcebytes levert.
aResponseContent	const TStream	Stream die de onbewerkte antwoordbody van de server vastlegt.

Opmerkingen

Stream-naar-stream-variant aanbevolen voor binaire resource-uploads, zoals afbeeldings- of bestandsvervangingen, waarbij zowel het verzoek als de respons het beste kunnen worden verwerkt zonder tekenreeksconversie.

Voorbeeld

oIn := TFileStream.Create('avatar.png', fmOpenRead);
oOut := TMemoryStream.Create;
try
  oClient.Put('https://api.example.com/users/42/avatar', oIn, oOut);
finally
  oOut.Free;
  oIn.Free;
end;