ClientFormsAuthenticationMembershipProvider.Logout メソッド

定義

ユーザーをログアウトします。

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

例外

IsOffline プロパティの値が false され、メンバーシップ プロバイダーが認証サービスにアクセスできません。

次のコード例は、このメソッドを使用してユーザーをログアウトする方法を示しています。

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

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

    try
    {
        authProvider.Logout();
    }
    catch (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;
    }

    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 をクリアし、staticThread.CurrentPrincipal プロパティを現在の WindowsIdentityを含む WindowsPrincipal オブジェクトにリセットします。

このメソッドを呼び出すと、現在のユーザーはクライアント アプリケーション サービスに対して認証されなくなります。 つまり、ClientSettingsProvider クラスを使用して、ClientRoleProvider クラスと設定を使用してロールを取得することはできません。 ただし、ユーザーは有効な Windows ID を持っている可能性があるため、次のようなコードから true 値を受け取る場合があります。Thread.CurrentPrincipal.Identity.IsAuthenticated。 ユーザーがクライアント アプリケーション サービスに対して認証されているかどうかを確認するには、staticCurrentPrincipal プロパティを使用して取得した IPrincipalIdentity プロパティ値が ClientFormsIdentity 参照であることを確認します。 次に、ClientFormsIdentity.IsAuthenticated プロパティを確認します。

現在のユーザーを再認証するには、ClientFormsAuthenticationMembershipProvider.ValidateUser メソッドまたは staticMembership.ValidateUser メソッドを呼び出します。

適用対象

こちらもご覧ください