WebRequestCreator.ClientHttp Property
Microsoft Silverlight will reach end of support after October 2021. Learn more.
Gets an object that specifies client HTTP handling for Web requests and responses.
Namespace: System.Net.Browser
Assembly: System.Windows (in System.Windows.dll)
Syntax
'Declaration
Public Shared ReadOnly Property ClientHttp As IWebRequestCreate
public static IWebRequestCreate ClientHttp { get; }
Property Value
Type: System.Net.IWebRequestCreate
An IWebRequestCreate object for use with Silverlight-based application that runs outside of a Web browser.
Remarks
With Silverlight, you can specify whether the browser or the client provides HTTP handling for your Silverlight-based applications. By default, HTTP handling is performed by the browser and you must opt-in to client HTTP handling.
The following is a list of scenarios that you would typically specify client HTTP handling for:
Using HTTP methods other than GET and POST.
Using response status codes, bodies and headers.
Sending HTTP XML requests such as messages to SOAP and REST services.
Manually managing cookies.
Examples
The following example shows you how to specify client HTTP handling for all messages.
Dim httpResult As Boolean = WebRequest.RegisterPrefix("http://", _
WebRequestCreator.ClientHttp)
Dim httpsResult As Boolean = WebRequest.RegisterPrefix("https://", _
WebRequestCreator.ClientHttp)
...
If httpResult = True Then
Dim wc As New WebClient()
wc.OpenReadAsync(New Uri( _
"http://api.search.live.net/qson.aspx?query=Silverlight"))
AddHandler wc.OpenReadCompleted, AddressOf wc_OpenReadCompleted
bool httpResult = WebRequest.RegisterPrefix("http://", WebRequestCreator.ClientHttp);
bool httpsResult = WebRequest.RegisterPrefix("https://", WebRequestCreator.ClientHttp);
...
if (httpResult == true)
{
WebClient wc = new WebClient();
wc.OpenReadAsync(new Uri("http://api.search.live.net/qson.aspx?query=Silverlight"));
wc.OpenReadCompleted += new OpenReadCompletedEventHandler(wc_OpenReadCompleted);
}
Version Information
Silverlight
Supported in: 5, 4, 3
Silverlight for Windows Phone
Supported in: Windows Phone OS 7.1, Windows Phone OS 7.0
Platforms
For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.