ClientFormsIdentity クラス

定義

public ref class ClientFormsIdentity : IDisposable, System::Security::Principal::IIdentity

public class ClientFormsIdentity : IDisposable, System.Security.Principal.IIdentity

type ClientFormsIdentity = class
    interface IIdentity
    interface IDisposable

Public Class ClientFormsIdentity
Implements IDisposable, IIdentity

継承

Object

ClientFormsIdentity

実装

IDisposable IIdentity

例

次のコード例は、このクラスを使用して、アプリケーションがオフライン状態を離れたときにユーザーをサイレント モードで再検証する方法を示しています。 この例では、CheckedChanged イベント ハンドラーは、チェック ボックスの値に一致するようにオフライン状態を更新します。 ユーザーがアプリケーションをオンライン状態に設定した場合、イベント ハンドラーは、RevalidateUser メソッドを呼び出してユーザーの再検証を試みます。 ただし、認証サーバーが使用できない場合、イベント ハンドラーはアプリケーションをオフライン状態に戻します。

private void workOfflineCheckBox_CheckedChanged(
    object sender, EventArgs e)
{
    ConnectivityStatus.IsOffline = workOfflineCheckBox.Checked;
    if (!ConnectivityStatus.IsOffline)
    {
        try
        {
            // Silently re-validate the user.
            ((ClientFormsIdentity)
                System.Threading.Thread.CurrentPrincipal.Identity)
                .RevalidateUser();

            // If any settings have been changed locally, save the new
            // new values to the Web settings service.
            SaveSettings();

            // If any settings have not been changed locally, check 
            // the Web settings service for updates. 
            Properties.Settings.Default.Reload();
        }
        catch (System.Net.WebException)
        {
            MessageBox.Show(
                "Unable to access the authentication service. " +
                Environment.NewLine + "Staying in offline mode.",
                "Warning", MessageBoxButtons.OK, 
                MessageBoxIcon.Warning);
            workOfflineCheckBox.Checked = true;
        }
    }
}

Private Sub workOfflineCheckBox_CheckedChanged( _
    ByVal sender As Object, ByVal e As EventArgs) _
    Handles workOfflineCheckBox.CheckedChanged

    ConnectivityStatus.IsOffline = workOfflineCheckBox.Checked
    If Not ConnectivityStatus.IsOffline Then

        Try

            ' Silently re-validate the user.
            CType(System.Threading.Thread.CurrentPrincipal.Identity,  _
                ClientFormsIdentity).RevalidateUser()

            ' If any settings have been changed locally, save the new
            ' new values to the Web settings service.
            SaveSettings()

            ' If any settings have not been changed locally, check 
            ' the Web settings service for updates. 
            My.Settings.Reload()

        Catch ex As System.Net.WebException

            MessageBox.Show( _
                "Unable to access the authentication service. " & _
                Environment.NewLine + "Staying in offline mode.", _
                "Warning", MessageBoxButtons.OK, MessageBoxIcon.Warning)
            workOfflineCheckBox.Checked = True

        End Try

    End If
End Sub

注釈

クライアント アプリケーション サービス機能では、このクラスを使用して認証されたユーザーを表します。 クライアント アプリケーション サービスとフォーム認証を使用するようにアプリケーションを構成する場合は、staticMembership.ValidateUser メソッドを呼び出してユーザーを認証できます。 認証後、staticThread.CurrentPrincipal プロパティを使用して取得した IPrincipal の Identity プロパティを使用して、現在の ClientFormsIdentity インスタンスへの参照を取得できます。 詳細については、「クライアント アプリケーション サービスの」を参照してください。

通常、このクラスへの直接の依存関係を回避するために、IIdentity 参照として ClientFormsIdentity オブジェクトにアクセスします。 ID の IIdentity.IsAuthenticated プロパティを調べて、ユーザーが認証されているかどうかを確認できます。 ただし、ユーザーは Windows では認証される可能性がありますが、クライアント アプリケーション サービスでは認証されません。 ユーザーがクライアント アプリケーション サービスに対して認証されているかどうかを確認するには、IIdentity.AuthenticationType プロパティ値が "ClientForms" であることを確認する必要もあります。

IIdentity インターフェイスで定義されていない RevalidateUser メソッドを呼び出すには、明示的な ClientFormsIdentity 参照を使用する必要があります。

コンストラクター

プロパティ

メソッド

適用対象

こちらもご覧ください

• ValidateUser(String, String)
• RevalidateUser()
• CurrentPrincipal
• IPrincipal
• Identity
• IIdentity
• IsAuthenticated
• IsAuthenticated
• AuthenticationType
• Logout()
• クライアント アプリケーション サービスの
• チュートリアル: クライアント アプリケーション サービス の使用