Partager via


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.