System.Net.HttpClient.THTTPClient.BeginMergeAlternative

From RAD Studio API Documentation
Jump to: navigation, search

Delphi 

function BeginMergeAlternative(const AURL: string; const ASource: TStream; const AHeaders: TNetHeaders = nil): IAsyncResult; overload;
function BeginMergeAlternative(const AsyncCallback: TAsyncCallback; const AURL: string; const ASource: TStream;  const AHeaders: TNetHeaders = nil): IAsyncResult; overload;
function BeginMergeAlternative(const AsyncCallbackEvent: TAsyncCallbackEvent; const AURL: string;  const ASource: TStream; const AHeaders: TNetHeaders = nil): IAsyncResult; overload;

C++ 

System::Types::_di_IAsyncResult __fastcall BeginMergeAlternative(const System::UnicodeString AURL, System::Classes::TStream* const ASource, const System::DynamicArray<System::Net::Urlclient::TNameValuePair> AHeaders = System::DynamicArray<System::Net::Urlclient::TNameValuePair>())/* overload */;
System::Types::_di_IAsyncResult __fastcall BeginMergeAlternative(const System::Classes::_di_TAsyncCallback AsyncCallback, const System::UnicodeString AURL, System::Classes::TStream* const ASource, const System::DynamicArray<System::Net::Urlclient::TNameValuePair> AHeaders = System::DynamicArray<System::Net::Urlclient::TNameValuePair>())/* overload */;
System::Types::_di_IAsyncResult __fastcall BeginMergeAlternative(const System::Classes::TAsyncProcedureEvent AsyncCallbackEvent, const System::UnicodeString AURL, System::Classes::TStream* const ASource, const System::DynamicArray<System::Net::Urlclient::TNameValuePair> AHeaders = System::DynamicArray<System::Net::Urlclient::TNameValuePair>())/* overload */;

Properties

Type Visibility Source Unit Parent
function public
System.Net.HttpClient.pas
System.Net.HTTPClient.hpp
 System.Net.HttpClient THTTPClient

Description

Starts an asynchronous HTTP request using the MERGE HTTP request method masked as a PUT HTTP request method.

Specifically, the HTTP request that BeginMergeAlternative sends uses PUT as HTTP request method and includes the following HTTP request headers to indicate that your request is actually a merge request:

  • X-Method-Override: PATCH
  • PatchType: MERGE

Use BeginMergeAlternative if your HTTP request must go through a proxy HTTP server that may not support the MERGE HTTP request method, otherwise you can use BeginMerge instead.

When you call BeginMergeAlternative, you must provide the data required to perform your HTTP request:

  • AURL is the target URL of your request.
  • ASource is a stream that contains the data to send.
  • AHeaders (optional) is a list of headers to include in the request.
  • AsyncCallback (optional) is a callback procedure to be called when a response is received or the request fails.
  • AsyncCallbackEvent (optional) is an event handler to be called when a response is received or the request fails.

For more information, see BeginExecute.

See Also

Retrieved from "http://docwiki.embarcadero.com/Libraries/Rio/e/index.php?title=System.Net.HttpClient.THTTPClient.BeginMergeAlternative&oldid=750436"