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 una trasmissione HTTP affidabile dal server Web a un client tramite l'URL.
Overload
UrlEncode(String) |
Codifica una stringa in URL e restituisce la stringa codificata. |
UrlEncode(String, TextWriter) |
Consente di codificare in URL una stringa e di inviare l'output risultante a un flusso di output di TextWriter. |
Commenti
UrlEncode è un modo pratico per accedere al HttpUtility.UrlEncode metodo in fase di esecuzione da un'applicazione ASP.NET. Internamente, UrlEncode usa HttpUtility.UrlEncode per codificare le stringhe.
Per codificare o decodificare i valori al di fuori di un'applicazione Web, usare la classe WebUtility.
UrlEncode(String)
Codifica una stringa in URL 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.
Restituisce
Testo codificato in URL.
Esempio
Nell'esempio seguente viene illustrato come codificare un valore url usato come valore 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 visualizzare il tipo di valore che è possibile codificare con URL. In genere, è possibile codificare un valore con URL 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 successivo è simile all'esempio precedente, ad eccezione del fatto che illustra come codificare un valore dall'URL all'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 (?), l'e commerciale (&), la 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 HttpUtility.UrlEncode metodo 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 HttpServerUtility classe tramite la Server
proprietà . 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)
Consente di codificare in URL una stringa e di inviare l'output risultante a un flusso di output di TextWriter.
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 di output TextWriter contenente 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 (?), l'e commerciale (&), la 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.
UrlEncode è un modo pratico per accedere al HttpUtility.UrlEncode metodo in fase di esecuzione da un'applicazione ASP.NET. Internamente, UrlEncode usa HttpUtility.UrlEncode per codificare le stringhe.
Per codificare o decodificare i valori al di fuori di un'applicazione Web, usare la classe WebUtility.