ClientFormsAuthenticationMembershipProvider.Logout ClientFormsAuthenticationMembershipProvider.Logout ClientFormsAuthenticationMembershipProvider.Logout ClientFormsAuthenticationMembershipProvider.Logout Method

定義

ユーザーをログアウトします。Logs out the user.

public:
 void Logout();
public void Logout ();
member this.Logout : unit -> unit
Public Sub Logout ()

例外

IsOffline プロパティの値が false で、メンバーシップ プロバイダーが認証サービスにアクセスできません。The IsOffline property value is false and the membership provider is unable to access the authentication service.

次のコード例は、このメソッドを使用してユーザーをログアウトする方法を示しています。The following example code demonstrates how to use this method to log out the user.

private void logoutButton_Click(object sender, EventArgs e)
{
    SaveSettings();

    ClientFormsAuthenticationMembershipProvider authProvider =
        (ClientFormsAuthenticationMembershipProvider)
        System.Web.Security.Membership.Provider;

    try
    {
        authProvider.Logout();
    }
    catch (WebException ex)
    {
        MessageBox.Show("Unable to access the authentication service." +
            Environment.NewLine + "Logging off locally only.",
            "Warning", MessageBoxButtons.OK, MessageBoxIcon.Warning);
        ConnectivityStatus.IsOffline = true;
        authProvider.Logout();
        ConnectivityStatus.IsOffline = false;
    }

    Application.Restart();
}
Private Sub logoutButton_Click(ByVal sender As Object, _
    ByVal e As EventArgs) Handles logoutButton.Click

    SaveSettings()

    Dim authProvider As ClientFormsAuthenticationMembershipProvider = _
        CType(System.Web.Security.Membership.Provider,  _
        ClientFormsAuthenticationMembershipProvider)

    Try

        authProvider.Logout()

    Catch ex As WebException

        MessageBox.Show("Unable to access the authentication service." & _
            Environment.NewLine & "Logging off locally only.", _
            "Warning", MessageBoxButtons.OK, MessageBoxIcon.Warning)
        ConnectivityStatus.IsOffline = True
        authProvider.Logout()
        ConnectivityStatus.IsOffline = False

    End Try

    Application.Restart()

End Sub

注釈

メソッドLogoutは、cookie キャッシュからすべての認証 cookie をクリアしstatic 、現在WindowsIdentityWindowsPrincipalを格納しているオブジェクトにThread.CurrentPrincipalプロパティをリセットします。The Logout method clears all authentication cookies from the cookie cache and resets the static Thread.CurrentPrincipal property to a WindowsPrincipal object that contains the current WindowsIdentity.

このメソッドを呼び出すと、現在のユーザーはクライアントアプリケーションサービスに対して認証されなくなります。After you call this method, the current user is no longer authenticated for client application services. つまり、クラスをClientRoleProvider ClientSettingsProvider介してロールを取得し、クラスを介して設定を取得することはできません。This means that you cannot retrieve roles through the ClientRoleProvider class and settings through the ClientSettingsProvider class. ただし、ユーザーには有効な Windows id がある可能性があるため、 true Thread.CurrentPrincipal.Identity.IsAuthenticated次のようなコードから値を受け取ることもあります。However, because the user might have a valid Windows identity, you might still receive a true value from code such as the following: Thread.CurrentPrincipal.Identity.IsAuthenticated. ユーザーがクライアントアプリケーションサービスに対して認証されているかどうIdentityかを判断するIPrincipalには、 staticプロパティにCurrentPrincipal ClientFormsIdentityよって取得されたのプロパティ値が参照であることを確認します。To determine whether the user is authenticated for client application services, confirm that the Identity property value of the IPrincipal retrieved through the static CurrentPrincipal property is a ClientFormsIdentity reference. 次に、 ClientFormsIdentity.IsAuthenticatedプロパティを確認します。Then, check the ClientFormsIdentity.IsAuthenticated property.

現在のユーザーを再認証するにClientFormsAuthenticationMembershipProvider.ValidateUser static Membership.ValidateUserは、メソッドまたはメソッドを呼び出します。To reauthenticate the current user, call the ClientFormsAuthenticationMembershipProvider.ValidateUser method or the static Membership.ValidateUser method.

適用対象

こちらもご覧ください