WebRequestCreator Class

[ This article is for Windows Phone 8 developers. If you’re developing for Windows 10, see the latest documentation. ]

Provides objects for specifying that the Windows Phone client handles HTTP requests and responses. Since the Windows Phone client provides HTTP handling by default, you typically never need to use this class.

Inheritance Hierarchy

System..::.Object
  System.Net.Browser..::.WebRequestCreator

Namespace:  System.Net.Browser
Assembly:  System.Windows (in System.Windows.dll)

Syntax

Public NotInheritable Class WebRequestCreator

public static class WebRequestCreator

The WebRequestCreator type exposes the following members.

Properties

	Name	Description
	ClientHttp	Gets an object that specifies client HTTP handling for Web requests and responses.

Top

Remarks

You pass the properties of this class to the RegisterPrefix method of WebRequest .

You can specify the scope for HTTP handling. For example, you can specify HTTP handling for all messages, for a particular domain, or for a single request object.

After you specify HTTP handling for a particular scheme or domain, you cannot change how HTTP messages to the domain or scheme are handled. If you try to call RegisterPrefix a second time for the same domain or prefix, the method will return false to indicate the register operation was not successful.

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=Windows"))
    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=Windows"));
    wc.OpenReadCompleted += new OpenReadCompletedEventHandler(wc_OpenReadCompleted);
}

Version Information

Windows Phone OS

Supported in: 8.1, 8.0, 7.1, 7.0

Platforms

Windows Phone

Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

See Also

Reference

System.Net.Browser Namespace

WebRequest