CreatingCookieEventArgs.CustomCredential プロパティ

  • リファレンス

定義

名前空間:
System.Web.ApplicationServices
アセンブリ:
System.Web.Extensions.dll

ユーザーが入力する追加の認証値を取得します。

public:
 property System::String ^ CustomCredential { System::String ^ get(); };
public string CustomCredential { get; }
member this.CustomCredential : string
Public ReadOnly Property CustomCredential As String

プロパティ値

String

認証に必要な、ユーザー名とパスワード以外のカスタム値。

例

次の例は、 イベントのイベント ハンドラーを CreatingCookie 示しています。 ハンドラーは、認証 Cookie をカスタマイズするために、 CreatingCookieEventArgs オブジェクトからユーザー値を取得します。 プロパティに CustomCredential 渡される値は、フォーム認証チケットの プロパティに格納されます UserData 。

注意

プロパティ内のデータが CustomCredential 機密でないことがわかっている場合にのみ、プロパティを Cookie に格納します。 悪意のあるユーザーは、Cookie の値にアクセスできます。

void AuthenticationService_CreatingCookie(object sender, 
    System.Web.ApplicationServices.CreatingCookieEventArgs e)
{
    FormsAuthenticationTicket ticket = new
          FormsAuthenticationTicket
            (1,
             e.UserName,
             DateTime.Now,
             DateTime.Now.AddMinutes(30),
             e.IsPersistent,
             e.CustomCredential,
             FormsAuthentication.FormsCookiePath);

    string encryptedTicket =
         FormsAuthentication.Encrypt(ticket);

    HttpCookie cookie = new HttpCookie
         (FormsAuthentication.FormsCookieName,
          encryptedTicket);
    cookie.Expires = DateTime.Now.AddMinutes(30);

    HttpContext.Current.Response.Cookies.Add(cookie);
    e.CookieIsSet = true;
}

Sub AuthenticationService_CreatingCookie(ByVal sender As Object, _
                 ByVal e As System.Web.ApplicationServices.CreatingCookieEventArgs)
    Dim ticket As FormsAuthenticationTicket = New _
       FormsAuthenticationTicket _
        (1, _
         e.Username, _
         DateTime.Now, _
         DateTime.Now.AddMinutes(30), _
         e.IsPersistent, _
         e.CustomCredential, _
         FormsAuthentication.FormsCookiePath)
        
    Dim encryptedTicket As String = FormsAuthentication.Encrypt(ticket)
    
    Dim cookie As HttpCookie = New _
        HttpCookie(FormsAuthentication.FormsCookieName, encryptedTicket)
    cookie.Expires = DateTime.Now.AddMinutes(30)
    
    HttpContext.Current.Response.Cookies.Add(cookie)
    e.CookieIsSet = True
End Sub

注釈

プロパティを CustomCredential 使用して、認証チケットのカスタム値を取得します。 プロパティには CustomCredential 、 メソッドに渡される値が Login 含まれています。 通常、このプロパティは、識別番号などのユーザー名とパスワードで検証する必要があるカスタム値を渡すために使用されます。 プロパティに複数の値が格納されている場合は、値を取得するために プロパティを CustomCredential 解析する必要があります。

適用対象