HttpServerUtility.UrlEncode Metódus

Definíció

Névtér:

System.Web

Szerelvény:

System.Web.dll

Kódol egy sztringet a megbízható HTTP-átvitelhez a webkiszolgálóról egy ügyfélre az URL-címen keresztül.

Túlterhelések

Name	Description
UrlEncode(String)	Az URL-kód egy sztringet kódol, és visszaadja a kódolt sztringet.
UrlEncode(String, TextWriter)	Az URL-kód egy sztringet kódol, és elküldi az eredményül kapott kimenetet egy TextWriter kimeneti streamnek.

Megjegyzések

A UrlEncode egy ASP.NET-alkalmazás futásidejű HttpUtility.UrlEncode metódusának kényelmes elérése. Belsőleg UrlEncode sztringek kódolására használ HttpUtility.UrlEncode .

Ha webalkalmazáson kívüli értékeket szeretne kódolni vagy dekódolni, használja az osztályt WebUtility .

UrlEncode(String)

Az URL-kód egy sztringet kódol, és visszaadja a kódolt sztringet.

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

Paraméterek

s

String

Az URL-kódolni kívánt szöveg.

Válaszok

String

Az URL-kódolású szöveg.

Példák

Az alábbi példa bemutatja, hogyan kódolható URL-cím egy hivatkozás lekérdezési sztringértékeként használt érték. A kód egy weblap kód mögötti fájljában található. A kódolandó érték ebben a példában csak azért van kódolva, hogy leegyszerűsítse a példát, és megjelenítse az URL-kódolású érték típusát. Általában a felhasználótól vagy a kéréstől kapott értéket fogja URL-címmel kódolni. NextPage vezérlőelemre HyperLink hivatkozik.

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

A következő példa az előző példához hasonló, de azt mutatja be, hogyan kódolhat url-címeket egy olyan osztályból, amely nem szerepel a kód mögötti fájlban.

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

Megjegyzések

Az URL-kódolás biztosítja, hogy minden böngésző megfelelően továbbítja a szöveget URL-sztringekben. Egyes böngészők csonkíthatják vagy megsérülhetik az olyan karaktereket, mint a kérdőjel (?), az ampersand (>), a perjel (/) és a szóköz. Ennek eredményeképpen ezeket a karaktereket címkékben <a> vagy lekérdezési sztringekben kell kódolni, ahol a sztringeket egy böngésző újraküldheti egy kérési sztringben.

Ezzel a módszerrel kényelmesen elérheti a HttpUtility.UrlEncode metódust futásidőben egy ASP.NET alkalmazásból. Ez a módszer belsőleg sztringek kódolására használja HttpUtility.UrlEncode .

Egy ASP.NET weblap kód mögötti fájljában a HttpServerUtility osztály egy példányát a Server tulajdonságon keresztül érheti el. Egy olyan osztályban, amely nem kód mögötti fájlban található, az osztály egy példányának HttpServerUtility eléréséhez használhatóHttpContext.Current.Server.

A webalkalmazáson kívül az osztály használatával kódolhatja vagy dekódolhatja az WebUtility értékeket.

UrlEncode(String, TextWriter)

Az URL-kód egy sztringet kódol, és elküldi az eredményül kapott kimenetet egy TextWriter kimeneti streamnek.

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)

Paraméterek

s

String

A kódolni kívánt szöveges sztring.

output

TextWriter

A TextWriter kódolt sztringet tartalmazó kimeneti adatfolyam.

Példák

Az alábbi példa egy sztringet kódol a HTTP általi átvitelhez. Kódolja az elnevezett TestStringsztringet, amely tartalmazza az "Ez egy tesztsztring>" szöveget, és a "This+is+a+%3cTest+String%3e." nevű EncodedString sztringbe <másolja.

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()
   

Megjegyzések

Az URL-kódolás biztosítja, hogy minden böngésző megfelelően továbbítja a szöveget URL-sztringekben. Egyes böngészők csonkíthatják vagy megsérülhetik az olyan karaktereket, mint a kérdőjel (?), az ampersand (>), a perjel (/) és a szóköz. Ennek eredményeképpen ezeket a karaktereket címkékben <a> vagy lekérdezési sztringekben kell kódolni, ahol a sztringeket egy böngésző újraküldheti egy kérési sztringben.

A UrlEncode egy ASP.NET-alkalmazás futásidejű HttpUtility.UrlEncode metódusának kényelmes elérése. Belsőleg UrlEncode sztringek kódolására használ HttpUtility.UrlEncode .

Ha webalkalmazáson kívüli értékeket szeretne kódolni vagy dekódolni, használja az osztályt WebUtility .