Was this page helpful?
Additional feedback?
1500 characters remaining
Export (0) Print
Expand All

WebClientProtocol.RequestEncoding Property


The Encoding used to make the client request to the XML Web service.

Namespace:   System.Web.Services.Protocols
Assembly:  System.Web.Services (in System.Web.Services.dll)

public Encoding RequestEncoding { get; set; }

Property Value

Type: System.Text.Encoding

The character encoding for the client request. The default is null, which uses the default encoding for the underlying transport and protocol.

The RequestEncoding determines the encoding for the request message. The ContentType of the request will be annotated with the encoding value.

Classes deriving from WebClientProtocol support a particular protocol, such as SoapHttpClientProtocol does for SOAP, set this property to conform to encoding requirements for the specific protocol. For example, the SoapHttpClientProtocol sets the default encoding to UTF-8.

The following example is an ASP.NET Web Form, which calls an XML Web service named Math. Within the EnterBtn_Click function, the Web Form explicitly sets RequestEncoding to UTF-8.

System_CAPS_security Security Note

This example has a text box that accepts user input, which is a potential security threat. By default, ASP.NET Web pages validate that user input does not include script or HTML elements. For more information, see Script Exploits Overview.

    <script language="C#" runat="server">
       void EnterBtn_Click(Object Src, EventArgs E) 
             MyMath.Math math = new MyMath.Math();

             // Set the Content Type to UTF-8.
             math.RequestEncoding = System.Text.Encoding.UTF8;

            int total = math.Add(Convert.ToInt32(Num1.Text), Convert.ToInt32(Num2.Text));
            Total.Text = "Total: " + total.ToString();


       <form action="MathClient.aspx" runat=server>

          Enter the two numbers you want to add and then press the Total button.
          Number 1: <asp:textbox id="Num1" runat=server/>  +
          Number 2: <asp:textbox id="Num2" runat=server/> =
          <asp:button text="Total" Onclick="EnterBtn_Click" runat=server/>
          <asp:label id="Total"  runat=server/>


.NET Framework
Available since 1.1
Return to top
Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
© 2015 Microsoft