HttpServerUtility.UrlEncode Metodo

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

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.

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

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.