WebRequestCreator.ClientHttp Property

Syntax

'Declaration
Public Shared ReadOnly Property ClientHttp As IWebRequestCreate

public static IWebRequestCreate ClientHttp { get; }

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.

See Also

Reference