WebClientProtocol.RequestEncoding WebClientProtocol.RequestEncoding WebClientProtocol.RequestEncoding WebClientProtocol.RequestEncoding Property

定義

クライアントが XML Web サービスを要求するときに使用される EncodingThe Encoding used to make the client request to the XML Web service.

public:
 property System::Text::Encoding ^ RequestEncoding { System::Text::Encoding ^ get(); void set(System::Text::Encoding ^ value); };
[System.ComponentModel.SettingsBindable(true)]
public System.Text.Encoding RequestEncoding { get; set; }
member this.RequestEncoding : System.Text.Encoding with get, set
Public Property RequestEncoding As Encoding

プロパティ値

クライアントによる要求に使用する文字エンコーディング。The character encoding for the client request. 既定値は null で、基になるトランスポートとプロトコルに既定のエンコーディングが使用されます。The default is null, which uses the default encoding for the underlying transport and protocol.

次の例は、という名前Mathの XML web サービスを呼び出す ASP.NET web フォームです。The following example is an ASP.NET Web Form, which calls an XML Web service named Math. EnterBtn_Click関数内では、Web フォームは明示的に requestencoding を utf-8 に設定します。Within the EnterBtn_Click function, the Web Form explicitly sets RequestEncoding to UTF-8.

重要

この例には、ユーザー入力を受け付けるテキスト ボックスがあります。これにより、セキュリティが脆弱になる可能性があります。This example has a text box that accepts user input, which is a potential security threat. 既定では、ASP.NET Web ページによって、ユーザー入力にスクリプトまたは HTML 要素が含まれていないかどうかが検証されます。By default, ASP.NET Web pages validate that user input does not include script or HTML elements. 詳細については、「スクリプトによる攻略の概要」を参照してください。For more information, see Script Exploits Overview.

<html>
    <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();
         }
 
    </script>
 
    <body>
       <form action="MathClient.aspx" runat=server>
           
          Enter the two numbers you want to add and then press the Total button.
          <p>
          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/>
          <p>
          <asp:label id="Total"  runat=server/>
          
       </form>
    </body>
 </html>
   
<html>
    <script language="VB" runat="server">
        Sub EnterBtn_Click(Src As Object, E As EventArgs)
            Dim math As New MyMath.Math()
            
            ' Set the Content Type to UTF-8.
            math.RequestEncoding = System.Text.Encoding.UTF8
            
            Dim iTotal As Integer = math.Add(Convert.ToInt32(Num1.Text), Convert.ToInt32(Num2.Text))
            Total.Text = "Total: " & iTotal.ToString()
        End Sub
 
    </script>
 
    <body>
       <form action="MathClient.aspx" runat=server>
           
          Enter the two numbers you want to add and then press the Total button.
          <p>
          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/>
          <p>
          <asp:label id="Total"  runat=server/>
          
       </form>
    </body>
 </html>
   

注釈

RequestEncoding 、要求メッセージのエンコーディングを決定します。The RequestEncoding determines the encoding for the request message. 要求ContentTypeのは、エンコーディング値で注釈が付けられます。The ContentType of the request will be annotated with the encoding value.

からWebClientProtocol派生しSoapHttpClientProtocolたクラスは、SOAP などの特定のプロトコルをサポートします。このプロパティは、特定のプロトコルのエンコード要件に準拠するように設定します。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. たとえば、はSoapHttpClientProtocol 、既定のエンコーディングを utf-8 に設定します。For example, the SoapHttpClientProtocol sets the default encoding to UTF-8.

適用対象

こちらもご覧ください