FormsAuthenticationTicket コンストラクタ

.NET Framework クラス ライブラリ リファレンス

FormsAuthenticationTicket コンストラクタ (Int32, String, DateTime, DateTime, Boolean, String)

Cookie 名、バージョン、有効期限、発行日時、永続性、およびユーザー固有のデータで FormsAuthenticationTicket クラスの新しいインスタンスを初期化します。Cookie パスは、アプリケーションの構成ファイル内で設定されている既定値になります。

名前空間: System.Web.Security
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Public Sub New ( _
    version As Integer, _
    name As String, _
    issueDate As DateTime, _
    expiration As DateTime, _
    isPersistent As Boolean, _
    userData As String _
)

Visual Basic (使用法)

Dim version As Integer
Dim name As String
Dim issueDate As DateTime
Dim expiration As DateTime
Dim isPersistent As Boolean
Dim userData As String

Dim instance As New FormsAuthenticationTicket(version,
 name, issueDate, expiration, isPersistent, userData)

C#

public FormsAuthenticationTicket (
    int version,
    string name,
    DateTime issueDate,
    DateTime expiration,
    bool isPersistent,
    string userData
)

C++

public:
FormsAuthenticationTicket (
    int version, 
    String^ name, 
    DateTime issueDate, 
    DateTime expiration, 
    bool isPersistent, 
    String^ userData
)

J#

public FormsAuthenticationTicket (
    int version, 
    String name, 
    DateTime issueDate, 
    DateTime expiration, 
    boolean isPersistent, 
    String userData
)

JScript

public function FormsAuthenticationTicket (
    version : int, 
    name : String, 
    issueDate : DateTime, 
    expiration : DateTime, 
    isPersistent : boolean, 
    userData : String
)

パラメータ

version

チケットのバージョン番号。

name

チケットに関連付けられているユーザー名。

issueDate

チケットが発行されたローカルの日付と時刻。

expiration

チケットの有効期限が切れるローカルの日付と時刻。

isPersistent

チケットを、複数のブラウザ セッションにわたって保存される永続的な Cookie に格納する場合は true。それ以外の場合は false。チケットが URL に格納される場合には、この値は無視されます。

userData

チケットに格納されるユーザー固有のデータ。

解説

このコンストラクタで作成される FormsAuthenticationTicket オブジェクトの CookiePath 値は FormsCookiePath の値に設定されます。

メモ
userData パラメータを null 参照 (Visual Basic では Nothing) にすることはできません。

プラットフォーム

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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
FormsAuthenticationTicket クラス
FormsAuthenticationTicket メンバ
System.Web.Security 名前空間
その他の技術情報
フォーム認証プロバイダ
フォーム認証プロバイダ

FormsAuthenticationTicket コンストラクタ (Int32, String, DateTime, DateTime, Boolean, String, String)

Cookie 名、バージョン、ディレクトリ パス、発行日時、有効期限、永続性、およびユーザー定義のデータで FormsAuthenticationTicket クラスの新しいインスタンスを初期化します。

名前空間: System.Web.Security
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Public Sub New ( _
    version As Integer, _
    name As String, _
    issueDate As DateTime, _
    expiration As DateTime, _
    isPersistent As Boolean, _
    userData As String, _
    cookiePath As String _
)

Visual Basic (使用法)

Dim version As Integer
Dim name As String
Dim issueDate As DateTime
Dim expiration As DateTime
Dim isPersistent As Boolean
Dim userData As String
Dim cookiePath As String

Dim instance As New FormsAuthenticationTicket(version,
 name, issueDate, expiration, isPersistent, userData, cookiePath)

C#

public FormsAuthenticationTicket (
    int version,
    string name,
    DateTime issueDate,
    DateTime expiration,
    bool isPersistent,
    string userData,
    string cookiePath
)

C++

public:
FormsAuthenticationTicket (
    int version, 
    String^ name, 
    DateTime issueDate, 
    DateTime expiration, 
    bool isPersistent, 
    String^ userData, 
    String^ cookiePath
)

J#

public FormsAuthenticationTicket (
    int version, 
    String name, 
    DateTime issueDate, 
    DateTime expiration, 
    boolean isPersistent, 
    String userData, 
    String cookiePath
)

JScript

public function FormsAuthenticationTicket (
    version : int, 
    name : String, 
    issueDate : DateTime, 
    expiration : DateTime, 
    isPersistent : boolean, 
    userData : String, 
    cookiePath : String
)

パラメータ

version

チケットのバージョン番号。

name

チケットに関連付けられているユーザー名。

issueDate

チケットが発行されたローカルの日付と時刻。

expiration

チケットの有効期限が切れるローカルの日付と時刻。

isPersistent

チケットを、複数のブラウザ セッションにわたって保存される永続的な Cookie に格納する場合は true。それ以外の場合は false。チケットが URL に格納される場合には、この値は無視されます。

userData

チケットに格納されるユーザー固有のデータ。

cookiePath

Cookie に格納される場合のチケットのパス。

解説

メモ
userData パラメータを null 参照 (Visual Basic では Nothing) にすることはできません。

使用例

FormsCookieName プロパティを使用して Encrypt メソッドの結果を Cookie に格納し、GetRedirectUrl メソッドから返される URL にユーザーをリダイレクトするコード例を次に示します。

Visual Basic

<%@ Page Language="VB" %>
<%@ Import Namespace="System.Web.Security"
 %>
<script runat="server">

  Private Sub Login_Click(sender As
 Object, e As EventArgs)
  
    ' Create a custom FormsAuthenticationTicket containing
    ' application specific data for the user.

    Dim username As String
      = UserNameTextBox.Text
    Dim password As String
      = UserPassTextBox.Text
    Dim isPersistent As Boolean
 = PersistCheckBox.Checked

    If Membership.ValidateUser(username, password) Then
    
      Dim userData As String
 = "ApplicationSpecific data for this user."

      Dim ticket As FormsAuthenticationTicket
 = New FormsAuthenticationTicket(1, _
        username, _
        DateTime.Now, _
        DateTime.Now.AddMinutes(30), _
        isPersistent, _
        userData, _
        FormsAuthentication.FormsCookiePath)

      ' Encrypt the ticket.
      Dim encTicket As String
 = FormsAuthentication.Encrypt(ticket)

      ' Create the cookie.
      Response.Cookies.Add(New HttpCookie(FormsAuthentication.FormsCookieName,
 encTicket))

      ' Redirect back to original URL.
      Response.Redirect(FormsAuthentication.GetRedirectUrl(username, isPersistent))
    Else    
      Msg.Text = "Login failed. Please check your user name and
 password and try again."
    End If
  End Sub

</script>
<html>
<head>
    <title>Forms Authentication Login</title>
</head>
<body>
    <form runat="server">
        <span style="BACKGROUND: #80ff80"> 
          <h3>Login Page</h3>
        </span> 
        <asp:Label id="Msg" ForeColor="maroon"
 runat="server" /><P>
        <table border=0>
            <tbody>
                <tr>
                    <td>Username:</td>
                    <td><asp:TextBox id="UserNameTextBox"
 type="text" runat="server"
 /></td>
                    <td>
                      <asp:RequiredFieldValidator id="RequiredFieldValidator1"
 
                                                  runat="server"
 ErrorMessage="*" 
                                                  Display="Static"
 
                                                  ControlToValidate="UserNameTextBox"
 />
                    </td>
                </tr>
                <tr>
                    <td>Password:</td>
                    <td><asp:TextBox id="UserPassTextBox"
 TextMode="Password" runat="server"
 /></td>
                    <td>
                      <asp:RequiredFieldValidator id="RequiredFieldValidator2"
 
                                                  runat="server"
 ErrorMessage="*" 
                                                  Display="Static"
 
                                                  ControlToValidate="UserPassTextBox"
 />
                    </td>
                </tr>
                <tr>
                    <td>Check here if this is
 <u>not</u><br>a public computer:</td>
                    <td><asp:CheckBox id="PersistCheckBox"
 runat="server" autopostback="true"
 /></td>
                </tr>
            </tbody>
        </table>
        <input type="submit" value="Login"
 runat="server" onserverclick="Login_Click"
 />
    </form>
</body>
</html>

C#

<%@ Page Language="C#" %>
<%@ Import Namespace="System.Web.Security" %>
<script runat="server">

  private void Login_Click(Object sender, EventArgs
 e)
  {
    // Create a custom FormsAuthenticationTicket containing
    // application specific data for the user.

    string username     = UserNameTextBox.Text;
    string password     = UserPassTextBox.Text;
    bool   isPersistent = PersistCheckBox.Checked;

    if (Membership.ValidateUser(username, password))
    {
      string userData = "ApplicationSpecific data for
 this user.";

      FormsAuthenticationTicket ticket = new FormsAuthenticationTicket(1
,
        username,
        DateTime.Now,
        DateTime.Now.AddMinutes(30),
        isPersistent,
        userData,
        FormsAuthentication.FormsCookiePath);

      // Encrypt the ticket.
      string encTicket = FormsAuthentication.Encrypt(ticket);

      // Create the cookie.
      Response.Cookies.Add(new HttpCookie(FormsAuthentication.FormsCookieName,
 encTicket));

      // Redirect back to original URL.
      Response.Redirect(FormsAuthentication.GetRedirectUrl(username, isPersistent));
    }
    else
    {
      Msg.Text = "Login failed. Please check your user name and password and
 try again.";
    }
  }

</script>
<html>
<head>
    <title>Forms Authentication Login</title>
</head>
<body>
    <form runat="server">
        <span style="BACKGROUND: #80ff80"> 
          <h3>Login Page</h3>
        </span> 
        <asp:Label id="Msg" ForeColor="maroon" runat="server"
 /><P>
        <table border=0>
            <tbody>
                <tr>
                    <td>Username:</td>
                    <td><asp:TextBox id="UserNameTextBox" type="text"
 runat="server" /></td>
                    <td>
                      <asp:RequiredFieldValidator id="RequiredFieldValidator1"
 
                                                  runat="server" ErrorMessage="*"
 
                                                  Display="Static" 
                                                  ControlToValidate="UserNameTextBox"
 />
                    </td>
                </tr>
                <tr>
                    <td>Password:</td>
                    <td><asp:TextBox id="UserPassTextBox" TextMode="Password"
 runat="server" /></td>
                    <td>
                      <asp:RequiredFieldValidator id="RequiredFieldValidator2"
 
                                                  runat="server" ErrorMessage="*"
 
                                                  Display="Static" 
                                                  ControlToValidate="UserPassTextBox"
 />
                    </td>
                </tr>
                <tr>
                    <td>Check here if this
 is <u>not</u><br>a public computer:</td>
                    <td><asp:CheckBox id="PersistCheckBox" runat="server"
 autopostback="true" /></td>
                </tr>
            </tbody>
        </table>
        <input type="submit" value="Login" runat="server"
 onserverclick="Login_Click" />
    </form>
</body>
</html>

プラットフォーム

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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
FormsAuthenticationTicket クラス
FormsAuthenticationTicket メンバ
System.Web.Security 名前空間
その他の技術情報
フォーム認証プロバイダ

FormsAuthenticationTicket コンストラクタ

FormsAuthenticationTicket クラスの新しいインスタンスを初期化します。 フォーム認証プロバイダ
オーバーロードの一覧

名前	説明
FormsAuthenticationTicket (String, Boolean, Int32)	Cookie 名と例外情報を使用して、FormsAuthenticationTicket クラスの新しいインスタンスを初期化します。
FormsAuthenticationTicket (Int32, String, DateTime, DateTime, Boolean, String)	Cookie 名、バージョン、有効期限、発行日時、永続性、およびユーザー固有のデータで FormsAuthenticationTicket クラスの新しいインスタンスを初期化します。Cookie パスは、アプリケーションの構成ファイル内で設定されている既定値になります。
FormsAuthenticationTicket (Int32, String, DateTime, DateTime, Boolean, String, String)	Cookie 名、バージョン、ディレクトリ パス、発行日時、有効期限、永続性、およびユーザー定義のデータで FormsAuthenticationTicket クラスの新しいインスタンスを初期化します。

参照

関連項目

FormsAuthenticationTicket クラス
FormsAuthenticationTicket メンバ
System.Web.Security 名前空間

その他の技術情報

フォーム認証プロバイダ

FormsAuthenticationTicket コンストラクタ (String, Boolean, Int32)

Cookie 名と例外情報を使用して、FormsAuthenticationTicket クラスの新しいインスタンスを初期化します。

名前空間: System.Web.Security
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Public Sub New ( _
    name As String, _
    isPersistent As Boolean, _
    timeout As Integer _
)

Visual Basic (使用法)

Dim name As String
Dim isPersistent As Boolean
Dim timeout As Integer

Dim instance As New FormsAuthenticationTicket(name,
 isPersistent, timeout)

C#

public FormsAuthenticationTicket (
    string name,
    bool isPersistent,
    int timeout
)

C++

public:
FormsAuthenticationTicket (
    String^ name, 
    bool isPersistent, 
    int timeout
)

J#

public FormsAuthenticationTicket (
    String name, 
    boolean isPersistent, 
    int timeout
)

JScript

public function FormsAuthenticationTicket (
    name : String, 
    isPersistent : boolean, 
    timeout : int
)

パラメータ

name

チケットに関連付けられているユーザー名。

isPersistent

チケットを、複数のブラウザ セッションにわたって保存される永続的な Cookie に格納する場合は true。それ以外の場合は false。チケットが URL に格納される場合には、この値は無視されます。

timeout

認証チケットの有効期間 (分単位)。

解説

このコンストラクタで作成される FormsAuthenticationTicket オブジェクトでは、CookiePath 値は FormsCookiePath プロパティ値に、Version 値は 2 に、IssueDate 値は現在のローカル日時に、UserData 値は空の文字列 ("") に、および Expiration 値は現在のローカル日時に timeout パラメータの値を加えた値に設定されます。

プラットフォーム

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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
FormsAuthenticationTicket クラス
FormsAuthenticationTicket メンバ
System.Web.Security 名前空間
その他の技術情報
フォーム認証プロバイダ