HttpServerUtility.UrlEncode Metodo
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.
Codifica una stringa per la trasmissione HTTP affidabile dal server Web a un client tramite l'URL.
Overload
| Nome | Descrizione |
|---|---|
| UrlEncode(String) |
L'URL codifica una stringa e restituisce la stringa codificata. |
| UrlEncode(String, TextWriter) |
L'URL codifica una stringa e invia l'output risultante a un TextWriter flusso di output. |
Commenti
Per codificare o decodificare i valori all'esterno di un'applicazione Web, usare la WebUtility classe .
UrlEncode(String)
L'URL codifica una stringa e restituisce la stringa codificata.
public:
System::String ^ UrlEncode(System::String ^ s);
public string UrlEncode(string s);
member this.UrlEncode : string -> string
Public Function UrlEncode (s As String) As String
Parametri
- s
- String
Testo da codificare in URL.
Valori restituiti
Testo con codifica URL.
Esempio
Nell'esempio seguente viene illustrato come codificare url un valore usato come valore della stringa di query di un collegamento ipertestuale. Il codice si trova nel file code-behind per una pagina Web. Il valore da codificare è hardcoded in questo esempio solo per semplificare l'esempio e mostrare il tipo di valore che è possibile codificare in URL. In genere, si codifica in URL un valore ricevuto dall'utente o dalla richiesta.
NextPage fa riferimento a un HyperLink controllo .
public partial class _Default : Page
{
protected void Page_Load(object sender, EventArgs e)
{
string destinationURL = "http://www.contoso.com/default.aspx?user=test";
NextPage.NavigateUrl = "~/Finish?url=" + Server.UrlEncode(destinationURL);
}
}
Public Class _Default
Inherits Page
Protected Sub Page_Load(ByVal sender As Object, ByVal e As EventArgs) Handles Me.Load
Dim destinationURL = "http://www.contoso.com/default.aspx?user=test"
NextPage.NavigateUrl = "~/Finish?url=" + Server.UrlEncode(destinationURL)
End Sub
End Class
L'esempio seguente è simile all'esempio precedente, ad eccezione del fatto che mostra come codificare url un valore dall'interno di una classe che non si trova nel file code-behind.
public class SampleClass
{
public string GetUrl()
{
string destinationURL = "http://www.contoso.com/default.aspx?user=test";
return "~/Finish?url=" + HttpContext.Current.Server.UrlEncode(destinationURL);
}
}
Public Class SampleClass
Public Function GetUrl() As String
Dim destinationURL = "http://www.contoso.com/default.aspx?user=test"
Return "~/Finish?url=" + HttpContext.Current.Server.UrlEncode(destinationURL)
End Function
End Class
Commenti
La codifica URL garantisce che tutti i browser trasmettano correttamente il testo nelle stringhe URL. I caratteri, ad esempio un punto interrogativo (?), la e commerciale (&), il segno di barra (/) e gli spazi potrebbero essere troncati o danneggiati da alcuni browser. Di conseguenza, questi caratteri devono essere codificati in <a> tag o in stringhe di query in cui le stringhe possono essere reinviate da un browser in una stringa di richiesta.
Questo metodo è un modo pratico per accedere al metodo HttpUtility.UrlEncode in fase di esecuzione da un'applicazione ASP.NET. Internamente, questo metodo usa HttpUtility.UrlEncode per codificare le stringhe.
Nel file code-behind per una pagina Web ASP.NET accedere a un'istanza della classe HttpServerUtility tramite la proprietà Server. In una classe che non si trova in un file code-behind, usare HttpContext.Current.Server per accedere a un'istanza della HttpServerUtility classe .
All'esterno di un'applicazione Web, usare la WebUtility classe per codificare o decodificare i valori.
Si applica a
UrlEncode(String, TextWriter)
L'URL codifica una stringa e invia l'output risultante a un TextWriter flusso di output.
public:
void UrlEncode(System::String ^ s, System::IO::TextWriter ^ output);
public void UrlEncode(string s, System.IO.TextWriter output);
member this.UrlEncode : string * System.IO.TextWriter -> unit
Public Sub UrlEncode (s As String, output As TextWriter)
Parametri
- s
- String
Stringa di testo da codificare.
- output
- TextWriter
Flusso TextWriter di output che contiene la stringa codificata.
Esempio
Nell'esempio seguente viene codificata una stringa per la trasmissione tramite HTTP. Codifica la stringa denominata TestString, che contiene il testo "This is a <Test String>." e la copia nella stringa denominata EncodedString "This+is+a+%3cTest+String%3e.".
String TestString = "This is a <Test String>.";
StringWriter writer = new StringWriter();
Server.UrlEncode(TestString, writer);
String EncodedString = writer.ToString();
Dim TestString As String = "This is a <Test String>."
Dim writer As New StringWriter
Server.UrlEncode(TestString, writer)
Dim EncodedString As String = writer.ToString()
Commenti
La codifica URL garantisce che tutti i browser trasmettano correttamente il testo nelle stringhe URL. I caratteri, ad esempio un punto interrogativo (?), la e commerciale (&), il segno di barra (/) e gli spazi potrebbero essere troncati o danneggiati da alcuni browser. Di conseguenza, questi caratteri devono essere codificati in <a> tag o in stringhe di query in cui le stringhe possono essere reinviate da un browser in una stringa di richiesta.
Per codificare o decodificare i valori all'esterno di un'applicazione Web, usare la WebUtility classe .