HttpUtility Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Stellt Methoden zum Codieren und Decodieren von URLs beim Verarbeiten von Webanforderungen bereit. Diese Klasse kann nicht vererbt werden.
public ref class HttpUtility sealed
public sealed class HttpUtility
type HttpUtility = class
Public NotInheritable Class HttpUtility
- Vererbung
-
HttpUtility
Beispiele
Im folgenden Codebeispiel wird die Verwendung der UrlEncodeUrlDecode Klassen und ParseQueryString Methoden veranschaulichtHttpUtility.
<%@ Page Language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
protected void Page_Load(object sender, EventArgs e)
{
String currurl = HttpContext.Current.Request.RawUrl;
String querystring = null;
// Check to make sure some query string variables
// exist and if not add some and redirect.
int iqs = currurl.IndexOf('?');
if (iqs == -1)
{
String redirecturl = currurl + "?var1=1&var2=2+2%2f3&var1=3";
Response.Redirect(redirecturl, true);
}
// If query string variables exist, put them in
// a string.
else if (iqs >= 0)
{
querystring = (iqs < currurl.Length - 1) ? currurl.Substring(iqs + 1) : String.Empty;
}
// Parse the query string variables into a NameValueCollection.
NameValueCollection qscoll = HttpUtility.ParseQueryString(querystring);
// Iterate through the collection.
StringBuilder sb = new StringBuilder();
foreach (String s in qscoll.AllKeys)
{
sb.Append(s + " - " + qscoll[s] + "<br />");
}
// Write the results to the appropriate labels.
ParseOutput.Text = sb.ToString();
UrlRawOutput.Text = currurl;
UrlEncodedOutput.Text = HttpUtility.UrlEncode(currurl);
UrlDecodedOutput.Text = HttpUtility.UrlDecode(currurl);
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>HttpUtility Example</title>
</head>
<body>
<form id="form1" runat="server">
<div>
The raw url is: <br />
<asp:Label id="UrlRawOutput"
runat="server" />
<br /><br />
The url encoded is: <br />
<asp:Label id="UrlEncodedOutput"
runat="server" />
<br /><br />
The url decoded is: <br />
<asp:Label id="UrlDecodedOutput"
runat="server" />
<br /><br />
The query string NameValueCollection is: <br />
<asp:Label id="ParseOutput"
runat="server" />
</div>
</form>
</body>
</html>
<%@ Page Language="VB" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
Protected Sub Page_Load(ByVal sender As Object, ByVal e As System.EventArgs)
Dim currurl As String = HttpContext.Current.Request.RawUrl
Dim querystring As String = Nothing
' Check to make sure some query string variables
' exist and if not add some and redirect.
Dim iqs As Int32 = currurl.IndexOf("?".ToCharArray())
If (iqs = -1) Then
Dim redirecturl As String = currurl & "?var1=1&var2=2+2%2f3&var1=3"
Response.Redirect(redirecturl, True)
' If query string variables exist, put them in
' a string.
ElseIf (iqs >= 0) Then
If (iqs < currurl.Length - 1) Then
querystring = currurl.Substring(iqs + 1)
End If
End If
' Parse the query string variables into a NameValueCollection.
Dim qscoll As NameValueCollection = HttpUtility.ParseQueryString(querystring)
' Iterate through the collection.
Dim sb As New StringBuilder()
For Each s As String In qscoll.AllKeys
sb.Append(s & " - " & qscoll(s) & "<br />")
Next s
' Write the results to the appropriate labels.
ParseOutput.Text = sb.ToString()
UrlRawOutput.Text = currurl
UrlEncodedOutput.Text = HttpUtility.UrlEncode(currurl)
UrlDecodedOutput.Text = HttpUtility.UrlDecode(currurl)
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>HttpUtility Example</title>
</head>
<body>
<form id="form1" runat="server">
<div>
The raw url is: <br />
<asp:Label id="UrlRawOutput"
runat="server" />
<br /><br />
The url encoded is: <br />
<asp:Label id="UrlEncodedOutput"
runat="server" />
<br /><br />
The url decoded is: <br />
<asp:Label id="UrlDecodedOutput"
runat="server" />
<br /><br />
The query string NameValueCollection is: <br />
<asp:Label id="ParseOutput"
runat="server" />
</div>
</form>
</body>
</html>
Hinweise
Die klasse HttpUtility wird intern von der klasse HttpServerUtility verwendet, deren Methoden und Eigenschaften über das systeminterne objekt ASP.NET Server verfügbar gemacht werden. Darüber hinaus enthält die HttpUtility Klasse Codierungs- und Decodierungshilfsmethoden, auf die nicht über die Server.
Verwenden Sie die WebUtility Klasse, um Werte außerhalb einer Webanwendung zu codieren oder zu decodieren.
Konstruktoren
| Name | Beschreibung |
|---|---|
| HttpUtility() |
Initialisiert eine neue Instanz der HttpUtility-Klasse. |
Methoden
| Name | Beschreibung |
|---|---|
| Equals(Object) |
Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object) |
| GetHashCode() |
Dient als Standardhashfunktion. (Geerbt von Object) |
| GetType() |
Ruft die Type der aktuellen Instanz ab. (Geerbt von Object) |
| HtmlAttributeEncode(String, TextWriter) |
Konvertiert eine Zeichenfolge minimal in eine HTML-codierte Zeichenfolge und sendet die codierte Zeichenfolge an einen TextWriter Ausgabedatenstrom. |
| HtmlAttributeEncode(String) |
Konvertiert eine Zeichenfolge minimal in eine HTML-codierte Zeichenfolge. |
| HtmlDecode(String, TextWriter) |
Konvertiert eine Zeichenfolge, die HTML-codiert wurde, in eine decodierte Zeichenfolge und sendet die decodierte Zeichenfolge an einen TextWriter Ausgabedatenstrom. |
| HtmlDecode(String) |
Konvertiert eine Zeichenfolge, die für die HTTP-Übertragung htmlcodiert wurde, in eine decodierte Zeichenfolge. |
| HtmlEncode(Object) |
Konvertiert die Zeichenfolgendarstellung eines Objekts in eine HTML-codierte Zeichenfolge und gibt die codierte Zeichenfolge zurück. |
| HtmlEncode(String, TextWriter) |
Konvertiert eine Zeichenfolge in eine HTML-codierte Zeichenfolge und gibt die Ausgabe als Ausgabedatenstrom zurück TextWriter . |
| HtmlEncode(String) |
Konvertiert eine Zeichenfolge in eine HTML-codierte Zeichenfolge. |
| JavaScriptStringEncode(String, Boolean) |
Codiert eine Zeichenfolge. |
| JavaScriptStringEncode(String) |
Codiert eine Zeichenfolge. |
| MemberwiseClone() |
Erstellt eine flache Kopie der aktuellen Object. (Geerbt von Object) |
| ParseQueryString(String, Encoding) |
Analysiert eine Abfragezeichenfolge mithilfe NameValueCollection des angegebenen Encoding. |
| ParseQueryString(String) |
Analysiert eine Abfragezeichenfolge in eine NameValueCollection using-Codierung UTF8 . |
| ToString() |
Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object) |
| UrlDecode(Byte[], Encoding) |
Wandelt ein URL-codiertes Bytearray mithilfe des angegebenen Decodierungsobjekts in eine decodierte Zeichenfolge um. |
| UrlDecode(Byte[], Int32, Int32, Encoding) |
Wandelt ein URL-codiertes Bytearray mithilfe des angegebenen Codierungsobjekts in eine decodierte Zeichenfolge um, beginnend an der angegebenen Position im Array und wird für die angegebene Anzahl von Bytes fortgesetzt. |
| UrlDecode(String, Encoding) |
Wandelt eine URL-codierte Zeichenfolge mithilfe des angegebenen Codierungsobjekts in eine decodierte Zeichenfolge um. |
| UrlDecode(String) |
Konvertiert eine Zeichenfolge, die für die Übertragung in einer URL codiert wurde, in eine decodierte Zeichenfolge. |
| UrlDecodeToBytes(Byte[], Int32, Int32) |
Wandelt ein URL-codiertes Bytearray in ein decodiertes Bytearray um, beginnend an der angegebenen Position im Array und wird für die angegebene Anzahl von Bytes fortgesetzt. |
| UrlDecodeToBytes(Byte[]) |
Konvertiert ein URL-codiertes Bytearray in ein decodiertes Bytearray. |
| UrlDecodeToBytes(String, Encoding) |
Konvertiert eine URL-codierte Zeichenfolge in ein decodiertes Bytearray mithilfe des angegebenen Decodierungsobjekts. |
| UrlDecodeToBytes(String) |
Konvertiert eine URL-codierte Zeichenfolge in ein decodiertes Bytearray. |
| UrlEncode(Byte[], Int32, Int32) |
Wandelt ein Bytearray in eine URL-codierte Zeichenfolge um, beginnend an der angegebenen Position im Array und wird für die angegebene Anzahl von Bytes fortgesetzt. |
| UrlEncode(Byte[]) |
Konvertiert ein Bytearray in eine codierte URL-Zeichenfolge. |
| UrlEncode(String, Encoding) |
Codiert eine URL-Zeichenfolge mithilfe des angegebenen Codierungsobjekts. |
| UrlEncode(String) |
Codiert eine URL-Zeichenfolge. |
| UrlEncodeToBytes(Byte[], Int32, Int32) |
Wandelt ein Bytearray in ein URL-codiertes Bytearray um, beginnend an der angegebenen Position im Array und wird für die angegebene Anzahl von Bytes fortgesetzt. |
| UrlEncodeToBytes(Byte[]) |
Wandelt ein Bytearray in ein URL-codiertes Bytearray um. |
| UrlEncodeToBytes(String, Encoding) |
Wandelt eine Zeichenfolge mithilfe des angegebenen Codierungsobjekts in ein URL-codiertes Bytearray um. |
| UrlEncodeToBytes(String) |
Konvertiert eine Zeichenfolge in ein URL-codiertes Bytearray. |
| UrlEncodeUnicode(String) |
Veraltet.
Konvertiert eine Zeichenfolge in eine Unicode-Zeichenfolge. |
| UrlEncodeUnicodeToBytes(String) |
Veraltet.
Konvertiert eine Unicode-Zeichenfolge in ein Bytearray. |
| UrlPathEncode(String) |
Nicht verwenden; Nur für Browserkompatibilität vorgesehen. Verwenden Sie UrlEncode(String). |