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.
La codifica (Encoding) utilizzata per effettuare la richiesta 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à
La codifica dei caratteri per la richiesta del client. Il valore predefinito è null
, che indica l'utilizzo della codifica predefinita per il trasporto e il protocollo sottostanti.
- Attributi
Esempio
L'esempio seguente è un ASP.NET Web Form, che chiama un servizio Web XML denominato Math
. All'interno della EnterBtn_Click
funzione, il Modulo Web imposta in modo esplicito RequestEncoding su UTF-8.
Importante
L'esempio include una casella di testo che accetta l'input dell'utente e rappresenta quindi una potenziale minaccia alla sicurezza. Per impostazione predefinita, le pagine Web ASP.NET verificano che l'input dell'utente non includa script o elementi HTML. Per altre informazioni, vedere Cenni preliminari sugli attacchi tramite 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 supporto di WebClientProtocol un protocollo specifico, ad esempio SoapHttpClientProtocol per SOAP, impostano questa proprietà per soddisfare i requisiti di codifica per il protocollo specifico. Ad esempio, imposta SoapHttpClientProtocol la codifica predefinita su UTF-8.