HttpCookieCollection 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.
Bietet eine typsichere Möglichkeit zum Bearbeiten von HTTP-Cookies.
public ref class HttpCookieCollection sealed : System::Collections::Specialized::NameObjectCollectionBasepublic sealed class HttpCookieCollection : System.Collections.Specialized.NameObjectCollectionBasetype HttpCookieCollection = class
inherit NameObjectCollectionBasePublic NotInheritable Class HttpCookieCollection
Inherits NameObjectCollectionBase- Vererbung
Beispiele
Im folgenden Codebeispiel wird veranschaulicht, wie Cookies mithilfe der Cookies Eigenschaft des HttpRequest Objekts gelesen und Cookies mithilfe der Cookies Eigenschaft des HttpResponse Objekts geschrieben werden. Beide Eigenschaften geben Objekte zurück HttpCookieCollection . Wenn eines von zwei Cookies benannt userName ist und lastVisit sich nicht in der HTTP-Anforderung befindet, werden sie in der HTTP-Antwort erstellt. Wenn die beiden Cookies vorhanden sind, werden die Eigenschaften der Cookies angezeigt.
<%@ 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)
{
StringBuilder sb = new StringBuilder();
// Check to see if cookies exist in HTTP request.
if (Request.Cookies["userName"] == null &&
Request.Cookies["lastVist"] == null)
{
Response.Cookies["userName"].Value = "user name";
Response.Cookies["userName"].Expires = DateTime.Now.AddMinutes(20d);
HttpCookie aCookie = new HttpCookie("lastVisit");
aCookie.Value = DateTime.Now.ToString();
aCookie.Expires = DateTime.Now.AddMinutes(20d);
Response.Cookies.Add(aCookie);
sb.Append("Two cookies added to response. " +
"Refresh the page to read the cookies.");
}
else
{
HttpCookieCollection cookies = Request.Cookies;
for (int i = 0; i < cookies.Count; i++)
{
sb.Append("Name: " + cookies[i].Name + "<br/>");
sb.Append("Value: " + cookies[i].Value + "<br/>");
sb.Append("Expires: " + cookies[i].Expires.ToString() +
"<br/><br/>");
}
}
Label1.Text = sb.ToString();
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>HttpCookieCollection Example</title>
</head>
<body>
<form id="form1" runat="server">
<div>
<asp:Label id="Label1" runat="server"></asp:Label>
</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 sb As New StringBuilder()
' Check to see if cookies exist in HTTP request.
If (Request.Cookies("userName") Is Nothing AndAlso _
Request.Cookies("lastVisit") Is Nothing) Then
Response.Cookies("userName").Value = "user name"
Response.Cookies("userName").Expires = DateTime.Now.AddMinutes(20D)
Dim aCookie As HttpCookie
aCookie = New HttpCookie("lastVisit")
aCookie.Value = DateTime.Now.ToString()
aCookie.Expires = DateTime.Now.AddMinutes(20D)
Response.Cookies.Add(aCookie)
sb.Append("Two cookies added to response. " & _
"Refresh the page to read the cookies.")
Else
Dim cookies As HttpCookieCollection
cookies = Request.Cookies
For i As Integer = 0 To cookies.Count - 1
sb.Append("Name: " & cookies(i).Name & "<br/>")
sb.Append("Value: " & cookies(i).Value & "<br/>")
sb.Append("Expires: " & cookies(i).Expires.ToString() & _
"<br/><br/>")
Next
End If
Label1.Text = sb.ToString()
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>HttpCookieCollection Example</title>
</head>
<body>
<form id="form1" runat="server">
<div>
<asp:Label id="Label1" runat="server"></asp:Label>
</div>
</form>
</body>
</html>
Konstruktoren
| Name | Beschreibung |
|---|---|
| HttpCookieCollection() |
Initialisiert eine neue Instanz der HttpCookieCollection-Klasse. |
Eigenschaften
| Name | Beschreibung |
|---|---|
| AllKeys |
Ruft ein Zeichenfolgenarray ab, das alle Schlüssel (Cookienamen) in der Cookieauflistung enthält. |
| Count |
Ruft die Anzahl der Schlüssel-Wert-Paare ab, die in der NameObjectCollectionBase Instanz enthalten sind. (Geerbt von NameObjectCollectionBase) |
| IsReadOnly |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob die NameObjectCollectionBase Instanz schreibgeschützt ist. (Geerbt von NameObjectCollectionBase) |
| Item[Int32] |
Ruft das Cookie mit dem angegebenen numerischen Index aus der Cookie-Auflistung ab. |
| Item[String] |
Ruft das Cookie mit dem angegebenen Namen aus der Cookiesammlung ab. |
| Keys |
Ruft eine NameObjectCollectionBase.KeysCollection Instanz ab, die alle Schlüssel in der NameObjectCollectionBase Instanz enthält. (Geerbt von NameObjectCollectionBase) |
Methoden
| Name | Beschreibung |
|---|---|
| Add(HttpCookie) |
Fügt das angegebene Cookie zur Cookiesammlung hinzu. |
| BaseAdd(String, Object) |
Fügt der Instanz einen Eintrag mit dem angegebenen Schlüssel und Wert hinzu NameObjectCollectionBase . (Geerbt von NameObjectCollectionBase) |
| BaseClear() |
Entfernt alle Einträge aus der NameObjectCollectionBase Instanz. (Geerbt von NameObjectCollectionBase) |
| BaseGet(Int32) |
Ruft den Wert des Eintrags am angegebenen Index der NameObjectCollectionBase Instanz ab. (Geerbt von NameObjectCollectionBase) |
| BaseGet(String) |
Ruft den Wert des ersten Eintrags mit dem angegebenen Schlüssel aus der NameObjectCollectionBase Instanz ab. (Geerbt von NameObjectCollectionBase) |
| BaseGetAllKeys() |
Gibt ein String Array zurück, das alle Schlüssel in der NameObjectCollectionBase Instanz enthält. (Geerbt von NameObjectCollectionBase) |
| BaseGetAllValues() |
Gibt ein Object Array zurück, das alle Werte in der NameObjectCollectionBase Instanz enthält. (Geerbt von NameObjectCollectionBase) |
| BaseGetAllValues(Type) |
Gibt ein Array des angegebenen Typs zurück, das alle Werte in der NameObjectCollectionBase Instanz enthält. (Geerbt von NameObjectCollectionBase) |
| BaseGetKey(Int32) |
Ruft den Schlüssel des Eintrags am angegebenen Index der NameObjectCollectionBase Instanz ab. (Geerbt von NameObjectCollectionBase) |
| BaseHasKeys() |
Ruft einen Wert ab, der angibt, ob die NameObjectCollectionBase Instanz Einträge enthält, deren Schlüssel nicht |
| BaseRemove(String) |
Entfernt die Einträge mit dem angegebenen Schlüssel aus der NameObjectCollectionBase Instanz. (Geerbt von NameObjectCollectionBase) |
| BaseRemoveAt(Int32) |
Entfernt den Eintrag am angegebenen Index der NameObjectCollectionBase Instanz. (Geerbt von NameObjectCollectionBase) |
| BaseSet(Int32, Object) |
Legt den Wert des Eintrags am angegebenen Index der NameObjectCollectionBase Instanz fest. (Geerbt von NameObjectCollectionBase) |
| BaseSet(String, Object) |
Legt den Wert des ersten Eintrags mit dem angegebenen Schlüssel in der NameObjectCollectionBase Instanz fest, falls gefunden. Andernfalls wird der Instanz ein Eintrag mit dem angegebenen Schlüssel und Wert NameObjectCollectionBase hinzugefügt. (Geerbt von NameObjectCollectionBase) |
| Clear() |
Löscht alle Cookies aus der Cookie-Sammlung. |
| CopyTo(Array, Int32) |
Kopiert Elemente der Cookiesammlung an einen Array Anfang am angegebenen Index des Arrays. |
| Equals(Object) |
Bestimmt, ob das angegebene Objekt dem aktuellen Objekt entspricht. (Geerbt von Object) |
| Get(Int32) |
Gibt das HttpCookie Element mit dem angegebenen Index aus der Cookieauflistung zurück. |
| Get(String) |
Gibt das Cookie mit dem angegebenen Namen aus der Cookiesammlung zurück. |
| GetEnumerator() |
Gibt einen Enumerator zurück, der durch die NameObjectCollectionBaseEnumerator durchläuft. (Geerbt von NameObjectCollectionBase) |
| GetHashCode() |
Dient als Standardhashfunktion. (Geerbt von Object) |
| GetKey(Int32) |
Gibt den Schlüssel (Namen) des Cookies am angegebenen numerischen Index zurück. |
| GetObjectData(SerializationInfo, StreamingContext) |
Veraltet.
Implementiert die ISerializable Schnittstelle und gibt die zum Serialisieren der NameObjectCollectionBase Instanz erforderlichen Daten zurück. (Geerbt von NameObjectCollectionBase) |
| GetType() |
Ruft die Type der aktuellen Instanz ab. (Geerbt von Object) |
| MemberwiseClone() |
Erstellt eine flache Kopie der aktuellen Object. (Geerbt von Object) |
| OnDeserialization(Object) |
Implementiert die ISerializable Schnittstelle und löst das Deserialisierungsereignis aus, wenn die Deserialisierung abgeschlossen ist. (Geerbt von NameObjectCollectionBase) |
| Remove(String) |
Entfernt das Cookie mit dem angegebenen Namen aus der Sammlung. |
| Set(HttpCookie) |
Aktualisiert den Wert eines vorhandenen Cookies in einer Cookiesammlung. |
| ToString() |
Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object) |
Explizite Schnittstellenimplementierungen
| Name | Beschreibung |
|---|---|
| ICollection.CopyTo(Array, Int32) |
Kopiert das Gesamte NameObjectCollectionBase in einen kompatiblen eindimensionalen Array, beginnend am angegebenen Index des Zielarrays. (Geerbt von NameObjectCollectionBase) |
| ICollection.IsSynchronized |
Ruft einen Wert ab, der angibt, ob der Zugriff auf das NameObjectCollectionBase Objekt synchronisiert wird (Threadsicher). (Geerbt von NameObjectCollectionBase) |
| ICollection.SyncRoot |
Ruft ein Objekt ab, das zum Synchronisieren des Zugriffs auf das NameObjectCollectionBase Objekt verwendet werden kann. (Geerbt von NameObjectCollectionBase) |
Erweiterungsmethoden
| Name | Beschreibung |
|---|---|
| AsParallel(IEnumerable) |
Aktiviert die Parallelisierung einer Abfrage. |
| AsQueryable(IEnumerable) |
Wandelt eine IEnumerable in eine IQueryableum. |
| Cast<TResult>(IEnumerable) |
Wandelt die Elemente eines IEnumerable in den angegebenen Typ um. |
| OfType<TResult>(IEnumerable) |
Filtert die Elemente einer IEnumerable basierend auf einem angegebenen Typ. |
