Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Ruft eine benutzerspezifische, mit dem Ticket gespeicherte Zeichenfolge ab.
Namespace: System.Web.Security
Assembly: System.Web (in system.web.dll)
Syntax
'Declaration
Public ReadOnly Property UserData As String
'Usage
Dim instance As FormsAuthenticationTicket
Dim value As String
value = instance.UserData
public string UserData { get; }
public:
property String^ UserData {
String^ get ();
}
/** @property */
public String get_UserData ()
public function get UserData () : String
Eigenschaftenwert
Eine benutzerspezifische, mit dem Ticket gespeicherte Zeichenfolge. Der Standardwert ist eine leere Zeichenfolge ("").
Hinweise
Wenn FormsAuthenticationTicket mit einem Konstruktor erstellt wird, der keinen userData-Parameter bereitstellt, gibt die UserData-Eigenschaft eine leere Zeichenfolge ("") zurück. Andernfalls gibt die Versionseigenschaft den an den FormsAuthenticationTicket-Konstruktor übergebenen Wert zurück.
Sie können die UserData-Eigenschaft verwenden, um mit dem FormsAuthenticationTicket zusätzliche Benutzerinformationen zu speichern, die nicht durch die FormsAuthenticationTicket-Eigenschaftenwerte verwaltet werden.
Hinweis
Sie sollten die in der UserData-Eigenschaft gespeicherte Datenmenge begrenzen. Sie müssen sicherstellen, dass die Größe der UserData-Eigenschaft kein ungültiges Cookie und keinen übermäßig langen URL zur Folge hat.
Beispiel
Im folgenden Codebeispiel sind die Eigenschaftenwerte von FormsAuthenticationTicket für den derzeit angemeldeten Benutzer dargestellt.
Hinweis
Wenn kein Benutzer angemeldet ist, ist die Identity-Eigenschaft NULL (Nothing in Visual Basic), und beim Versuch, die Identity-Eigenschaft in ein FormsIdentity-Objekt umzuwandeln, wird vom Compiler eine Ausnahme ausgelöst.
<%@ Page Language="VB" AutoEventWireup="true"%>
<script runat="server">
Sub Page_Load(sender As Object, e As EventArgs)
Welcome.InnerHtml = "Hello, " + _
Server.HtmlEncode(User.Identity.Name)
Dim id As FormsIdentity = CType(User.Identity, FormsIdentity)
Dim ticket As FormsAuthenticationTicket = id.Ticket
cookiePath.Text = ticket.CookiePath
expireDate.Text = ticket.Expiration.ToString()
expired.Text = ticket.Expired.ToString()
isPersistent.Text = ticket.IsPersistent.ToString()
issueDate.Text = ticket.IssueDate.ToString()
name.Text = ticket.Name
userData.Text = ticket.UserData
version.Text = ticket.Version.ToString()
End Sub
Sub Signout_Click(sender As Object, e As EventArgs)
FormsAuthentication.SignOut()
Response.Write("Logged out - cookie deleted.")
End Sub
</script>
<html>
<head>
<title>Forms Authentication</title>
</head>
<body>
<h3>Forms Authentication Example</font>
</h3>
<span id="Welcome" runat="server"> </span>
<form runat="server">
<input type="submit" value="Signout" runat="server" onserverclick="Signout_Click" />
<h3>Forms Authentication Ticket Properties</font>
<table>
<tbody>
<tr>
<td>
CookiePath:
</td>
<td><asp:Label id="cookiePath" runat="server" />
</td>
</tr>
<tr>
<td>
Expiration:
</td>
<td><asp:Label id="expireDate" runat="server" />
</td>
</tr>
<tr>
<td>
Expired:
</td>
<td><asp:Label id="expired" runat="server" />
</td>
</tr>
<tr>
<td>
IsPersistent:
</td>
<td><asp:Label id="isPersistent" runat="server" />
</td>
</tr>
<tr>
<td>
IssueDate:
</td>
<td><asp:Label id="issueDate" runat="server" />
</td>
</tr>
<tr>
<td>
Name:
</td>
<td><asp:Label id="name" runat="server" />
</td>
</tr>
<tr>
<td>
UserData:
</td>
<td><asp:Label id="userData" runat="server" />
</td>
</tr>
<tr>
<td>
Version:
</td>
<td><asp:Label id="version" runat="server" />
</td>
</tr>
</tbody>
</table>
<p>
</p>
</h3>
</form>
</span>
</body>
</html>
<%@ Page Language="C#" AutoEventWireup="true"%>
<script runat="server">
private void Page_Load(Object Src, EventArgs e)
{
Welcome.InnerHtml = "Hello, " +
Server.HtmlEncode(User.Identity.Name);
FormsIdentity id = (FormsIdentity)User.Identity;
FormsAuthenticationTicket ticket = id.Ticket;
cookiePath.Text = ticket.CookiePath;
expireDate.Text = ticket.Expiration.ToString();
expired.Text = ticket.Expired.ToString();
isPersistent.Text = ticket.IsPersistent.ToString();
issueDate.Text = ticket.IssueDate.ToString();
name.Text = ticket.Name;
userData.Text = ticket.UserData;
version.Text = ticket.Version.ToString();
}
private void Signout_Click(Object sender, EventArgs e)
{
FormsAuthentication.SignOut();
Response.Write("Logged out - cookie deleted.");
}
</script>
<html>
<head>
<title>Forms Authentication</title>
</head>
<body>
<h3>Forms Authentication Example</font>
</h3>
<span id="Welcome" runat="server"> </span>
<form runat="server">
<input type="submit" value="Signout" runat="server" onserverclick="Signout_Click" />
<h3>Forms Authentication Ticket Properties</font>
<table>
<tbody>
<tr>
<td>
CookiePath:
</td>
<td><asp:Label id="cookiePath" runat="server" />
</td>
</tr>
<tr>
<td>
Expiration:
</td>
<td><asp:Label id="expireDate" runat="server" />
</td>
</tr>
<tr>
<td>
Expired:
</td>
<td><asp:Label id="expired" runat="server" />
</td>
</tr>
<tr>
<td>
IsPersistent:
</td>
<td><asp:Label id="isPersistent" runat="server" />
</td>
</tr>
<tr>
<td>
IssueDate:
</td>
<td><asp:Label id="issueDate" runat="server" />
</td>
</tr>
<tr>
<td>
Name:
</td>
<td><asp:Label id="name" runat="server" />
</td>
</tr>
<tr>
<td>
UserData:
</td>
<td><asp:Label id="userData" runat="server" />
</td>
</tr>
<tr>
<td>
Version:
</td>
<td><asp:Label id="version" runat="server" />
</td>
</tr>
</tbody>
</table>
<p>
</p>
</h3>
</form>
</span>
</body>
</html>
Plattformen
Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.
Versionsinformationen
.NET Framework
Unterstützt in: 2.0, 1.1, 1.0
Siehe auch
Referenz
FormsAuthenticationTicket-Klasse
FormsAuthenticationTicket-Member
System.Web.Security-Namespace