GlobalizationSection.RequestEncoding Property

Reference

Definition

Namespace:: System.Web.Configuration

Assembly:: System.Web.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Gets or sets a value specifying the content encoding of HTTP requests.

public:
 property System::Text::Encoding ^ RequestEncoding { System::Text::Encoding ^ get(); void set(System::Text::Encoding ^ value); };

[System.Configuration.ConfigurationProperty("requestEncoding", DefaultValue="utf-8")]
public System.Text.Encoding RequestEncoding { get; set; }

[<System.Configuration.ConfigurationProperty("requestEncoding", DefaultValue="utf-8")>]
member this.RequestEncoding : System.Text.Encoding with get, set

Public Property RequestEncoding As Encoding

Property Value

Encoding

The content encoding of HTTP requests. The default is UTF-8.

Attributes: ConfigurationPropertyAttribute

Examples

The following code example demonstrates how to use the RequestEncoding property. This code example is part of a larger example provided for the GlobalizationSection class.

// Display RequestEncoding property.
Console.WriteLine("RequestEncoding: {0}",
  configSection.RequestEncoding);

' Display RequestEncoding property.
Console.WriteLine("RequestEncoding: {0}", _
 configSection.RequestEncoding)

Remarks

The RequestEncoding property specifies the assumed encoding of each incoming HTTP request, including posted data and query-string data. If the request comes with a request header containing a ContentType field, the AcceptCharset field of the request header overrides the RequestEncoding of the configuration.

The default encoding is UTF-8, specified in the globalization section of the Machine.config file that was created when the .NET Framework was installed. If the RequestEncoding property is not specified in the Machine.config or Web.config file, encoding defaults to the Regional Options locale setting on the computer. For single-server applications, the RequestEncoding and ResponseEncoding properties should be the same. When using multiple server applications where the default server encodings are different, you can use local Web.config files to vary the RequestEncoding and ResponseEncoding properties.

Applies to

Jaa