Article
11/17/2011

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.

Share via