WebClientProtocol.RequestEncoding Proprietà
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Oggetto Encoding utilizzato per effettuare la richiesta client al servizio Web XML.
public:
property System::Text::Encoding ^ RequestEncoding { System::Text::Encoding ^ get(); void set(System::Text::Encoding ^ value); };
public System.Text.Encoding RequestEncoding { get; set; }
[System.ComponentModel.SettingsBindable(true)]
public System.Text.Encoding RequestEncoding { get; set; }
member this.RequestEncoding : System.Text.Encoding with get, set
[<System.ComponentModel.SettingsBindable(true)>]
member this.RequestEncoding : System.Text.Encoding with get, set
Public Property RequestEncoding As Encoding
Valore della proprietà
Codifica dei caratteri per la richiesta client. Il valore predefinito è null, che usa la codifica predefinita per il trasporto e il protocollo sottostanti.
- Attributi
Esempio
L'esempio seguente è un web form ASP.NET, che chiama un servizio Web XML denominato Math. All'interno della EnterBtn_Click funzione, il Web Form imposta in modo esplicito RequestEncoding su UTF-8.
Importante
In questo esempio è presente una casella di testo che accetta l'input dell'utente, che rappresenta una potenziale minaccia per la sicurezza. Per impostazione predefinita, ASP.NET pagine Web verificare che l'input dell'utente non includa elementi SCRIPT o HTML. Per altre informazioni, vedere Cenni preliminari sugli exploit di script.
<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>
Commenti
Determina RequestEncoding la codifica per il messaggio di richiesta. L'oggetto ContentType della richiesta verrà annotato con il valore di codifica.
Le classi derivate dal WebClientProtocol supporto di un particolare protocollo, ad esempio SoapHttpClientProtocol per SOAP, impostano questa proprietà in modo che siano conformi ai requisiti di codifica per il protocollo specifico. Ad esempio, SoapHttpClientProtocol imposta la codifica predefinita su UTF-8.