• Article

HttpWebRequest.Method Property

Microsoft Silverlight will reach end of support after October 2021. Learn more.

Gets or sets the method for the request.

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

Syntax

'Declaration
Public Overrides Property Method As String

public override string Method { get; set; }

Property Value

Type: System.String
The request method to use to contact the Internet resource. The default value is GET.

Exceptions

Exception Condition
ArgumentException

No method is supplied.

-or-

The method string contains invalid characters.
NotImplementedException

This property is not implemented.
NotSupportedException

The Method property is not GET or POST.

Remarks

The Method property can only be set to GET and POST methods. Any other HTTP 1.1 or 1.0 protocol verbs (HEAD, PUT, DELETE, TRACE, or OPTIONS, for example) will throw a NotSupportedException exception.

If an application implements a custom WebRequest class and does not override the Method property, then the NotImplementedException is thrown.

Examples

' Change this Uri to a public server
Dim myUri As System.Uri = New Uri("https://www.contoso.com")

' Create a 'HttpWebRequest' object.
Dim myHttpWebRequest As HttpWebRequest = WebRequest.Create(myUri)

' Set the 'Method' property to "POST".
myHttpWebRequest.Method="PUT"

' Set the 'ContentType' property.
myHttpWebRequest.ContentType="application/x-www-form-urlencoded"

' Get the 'ContentType' property and print the current value
outputBlock.Text &= "HttpWebRequest.ContentType: "
outputBlock.Text &= myHttpWebRequest.ContentType
outputBlock.Text &= vbCrLf

        // Change this Uri to a public server
        System.Uri myUri = new Uri("https://www.contoso.com");

        // Create a 'HttpWebRequest' object.
        HttpWebRequest myHttpWebRequest=(HttpWebRequest)WebRequest.Create(myUri);

        // Set the 'Method' property to "POST".
        myHttpWebRequest.Method="PUT";

        // Set the 'ContentType' property.
        myHttpWebRequest.ContentType="application/x-www-form-urlencoded";

        // Get the 'ContentType' property and print the current value
        outputBlock.Text += "HttpWebRequest.ContentType: ";
        outputBlock.Text += myHttpWebRequest.ContentType;
        outputBlock.Text += "\n";

Version Information

Silverlight

Supported in: 5, 4, 3

Silverlight for Windows Phone

Supported in: Windows Phone OS 7.1, Windows Phone OS 7.0

XNA Framework

Supported in: 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.