FormsAuthentication.SetAuthCookie Methode

Definition

Namespace:

System.Web.Security

Assembly:

System.Web.dll

Erstellt ein Authentifizierungsticket für den angegebenen Benutzernamen und fügt es der Cookieauflistung der Antwort oder der URL hinzu, wenn die Authentifizierung ohne Cookies verwendet wird.

Überlädt

SetAuthCookie(String, Boolean)	Erstellt ein Authentifizierungsticket für den angegebenen Benutzernamen und fügt es der Cookieauflistung der Antwort oder der URL hinzu, wenn die Authentifizierung ohne Cookies verwendet wird.
SetAuthCookie(String, Boolean, String)	Erstellt ein Authentifizierungsticket für den angegebenen Benutzernamen und fügt es der Cookieauflistung der Antwort unter Verwendung des angegebenen Cookiepfads oder, wenn die Authentifizierung ohne Cookies verwendet wird, unter Verwendung der URL hinzu.

Hinweise

Die SetAuthCookie -Methode fügt entweder der Cookiessammlung oder der URL, wenn CookiesSupported ist false, ein Formularauthentifizierungsticket hinzu. Das Formularauthentifizierungsticket stellt Formularauthentifizierungsinformationen für die nächste Anforderung bereit, die vom Browser gestellt wird. Bei der Formularauthentifizierung können Sie die SetAuthCookie -Methode verwenden, wenn Sie einen Benutzer authentifizieren möchten, aber weiterhin die Kontrolle über die Navigation mit Umleitungen behalten.

SetAuthCookie(String, Boolean)

Erstellt ein Authentifizierungsticket für den angegebenen Benutzernamen und fügt es der Cookieauflistung der Antwort oder der URL hinzu, wenn die Authentifizierung ohne Cookies verwendet wird.

public:
 static void SetAuthCookie(System::String ^ userName, bool createPersistentCookie);

public static void SetAuthCookie (string userName, bool createPersistentCookie);

static member SetAuthCookie : string * bool -> unit

Public Shared Sub SetAuthCookie (userName As String, createPersistentCookie As Boolean)

Parameter

userName

String

Der Name eines authentifizierten Benutzers. Eine Zuordnung zu einem Windows-Konto ist hier nicht erforderlich.

createPersistentCookie

Boolean

true, um ein permanentes Cookie (das über Browsersitzungen hinweg gespeichert wird) zu erstellen, andernfalls false.

Ausnahmen

HttpException

RequireSSL ist true, und IsSecureConnection ist false.

Hinweise

Die SetAuthCookie -Methode fügt entweder der Cookiessammlung oder der URL ein Formularauthentifizierungsticket hinzu, wenn CookiesSupported ist false. Das Formularauthentifizierungsticket stellt Formularauthentifizierungsinformationen für die nächste Anforderung bereit, die vom Browser gestellt wird. Bei der Formularauthentifizierung können Sie die SetAuthCookie -Methode verwenden, wenn Sie einen Benutzer authentifizieren möchten, aber weiterhin die Kontrolle über die Navigation mit Umleitungen behalten.

Weitere Informationen

• Sicherheit von ASP.NET-Webanwendungen

SetAuthCookie(String, Boolean, String)

Erstellt ein Authentifizierungsticket für den angegebenen Benutzernamen und fügt es der Cookieauflistung der Antwort unter Verwendung des angegebenen Cookiepfads oder, wenn die Authentifizierung ohne Cookies verwendet wird, unter Verwendung der URL hinzu.

public:
 static void SetAuthCookie(System::String ^ userName, bool createPersistentCookie, System::String ^ strCookiePath);

public static void SetAuthCookie (string userName, bool createPersistentCookie, string strCookiePath);

static member SetAuthCookie : string * bool * string -> unit

Public Shared Sub SetAuthCookie (userName As String, createPersistentCookie As Boolean, strCookiePath As String)

Parameter

userName

String

Der Name eines authentifizierten Benutzers.

createPersistentCookie

Boolean

true, um ein permanentes Cookie (das über Browsersitzungen hinweg gespeichert wird) zu erstellen, andernfalls false.

strCookiePath

String

Der Cookiepfad für das Formularauthentifizierungsticket.

Ausnahmen

HttpException

RequireSSL ist true, und IsSecureConnection ist false.

Hinweise

Die SetAuthCookie -Methode fügt entweder der Cookiessammlung oder der URL, wenn CookiesSupported ist false, ein Formularauthentifizierungsticket hinzu. Das Formularauthentifizierungsticket stellt Formularauthentifizierungsinformationen für die nächste Anforderung bereit, die vom Browser gestellt wird. Bei der Formularauthentifizierung können Sie die SetAuthCookie -Methode verwenden, wenn Sie einen Benutzer authentifizieren möchten, aber weiterhin die Kontrolle über die Navigation mit Umleitungen behalten.

Weitere Informationen

• Sicherheit von ASP.NET-Webanwendungen
• Erläuterung: Formularauthentifizierung in ASP.NET 2.0
• Vorgehensweise: Verwenden der Mitgliedschaft in ASP.NET 2.0