TsgcHTTP3Client › Metody › Put

Put Metoda

Wysyła synchroniczne żądanie HTTP/3 PUT z treścią i zwraca treść odpowiedzi.

Składnia

function Put(const aURL: string; const aData: string; const aContentType: string = 'application/json'): string; overload;
procedure Put(const aURL: string; const aSource: TStream; const aResponseContent: TStream); overload;

Parametry

NazwaTypOpis
aURLconst stringBezwzględny adres URL zasobu, do którego wysyłane jest żądanie.
aDataconst stringTreść żądania wysłana do serwera.
aContentTypeconst stringWartość nagłówka content-type. Domyślna wartość to application/json.
aSourceTStreamStrumień, którego zawartość jest wysyłana jako treść żądania (tylko przeciążenie strumieniowe).
aResponseContentTStreamStrumień odbierający surową treść odpowiedzi (tylko przeciążenie strumieniowe).

Wartość zwracana

Treść odpowiedzi otrzymana od serwera, zdekodowana jako ciąg znaków. Przeciążenie strumieniowe zapisuje treść do aResponseContent. (string)

Uwagi

Put blokuje wątek wywołujący do momentu odebrania pełnej odpowiedzi HTTP/3. Użyj pierwszego przeciążenia, aby wysłać treść tekstową, ustawiając aContentType odpowiednio do zawartości; użyj przeciążenia strumieniowego, aby wysłać treść żądania z TStream i zapisać odpowiedź do innego strumienia. W przypadku żądania nieblokującego użyj PutAsync, które dostarcza odpowiedź przez OnResponse.

Przykład


vResponse := oClient.Put('https://api.example.com/v1/users/42', '{"name":"john"}');

Powrót do metod