Freigeben über

HttpCookie(String, String, String) Konstruktor

  • Referenz

Definition

Namespace:
Windows.Web.Http
Bearbeiten

Initialisiert eine neue instance der HttpCookie-Klasse mit einem angegebenen Namen, einer angegebenen Domäne und einem angegebenen Pfad.

public:
 HttpCookie(Platform::String ^ name, Platform::String ^ domain, Platform::String ^ path);
 HttpCookie(winrt::hstring const& name, winrt::hstring const& domain, winrt::hstring const& path);
public HttpCookie(string name, string domain, string path);
function HttpCookie(name, domain, path)
Public Sub New (name As String, domain As String, path As String)

Parameter

name
String

Platform::String

winrt::hstring

Der Name für das HttpCookie

domain
String

Platform::String

winrt::hstring

Die Domäne, für die httpCookie gültig ist.

path
String

Platform::String

winrt::hstring

Die URIs, auf die httpCookie angewendet wird.

Hinweise

Der Name-Parameter von HttpCookie kann nicht auf NULL (Nothing in Visual Basic) festgelegt werden.

Die Eigenschaft sollte ein Token sein, wie in RFC 2616 und RFC 6265 definiert.

Die folgenden Zeichen werden als Trennzeichen verwendet und können nicht im parameter name verwendet werden:

  • left paren ('(')
  • right paren (')')
  • größer als ('>')
  • kleiner als ('<')
  • at-Zeichen ('@')
  • Komma (',')
  • Semikolon (';')
  • Doppelpunkt (':')
  • umgekehrter Schrägstrich ('\')
  • doppeltes Anführungszeichen ('"')
  • Schrägstrich ('/')
  • linke eckige Klammer ('[')
  • rechte eckige Klammer (']')
  • Fragezeichen ('?')
  • Gleichheitszeichen ('=')
  • linke Wellenlinie ('{')
  • rechte wellenbündige Klammer ('}')
  • neue Zeile ('\n')
  • return ('\r")
  • Leerzeichen (' ')
  • tab ('\t")

Der Parameter *domain * gibt die Hosts an, an die die HttpCookie gesendet wird. Ein Cookie mit dem Parameter *domain * von .contoso.com wird an die contoso.com Domäne und alle Unterdomänen (www.contoso.com und info.contoso.com) gesendet.

Ein Cookie mit dem Parameter *domain * von info.contoso.com wird nicht an contoso.com oder www.contoso.comgesendet, sondern an info.contoso.com und alle Unterdomänen (uk.info.contoso.com und us.info.contoso.com, z. B. ) gesendet.

Wenn der Domänenparameter nicht angegeben ist, wird httpCookie nur an den Host und die Unterdomänen des Hosts gesendet, von denen dieses Cookie empfangen wurde.

Der path-Parameter gibt die Teilmenge der Pfade auf dem Ursprungsserver an, auf die dieses HttpCookie angewendet wird. Wenn dieser Parameter nicht angegeben ist, stimmt der Standardpfad mit jedem Pfad überein, und httpCookie wird bei allen HTTP-Anforderungen an den angegebenen Parameter *domain * und alle Unterdomänen gesendet.

Gilt für: