通过

ClientFormsIdentity 类

  • 参考

定义

命名空间:
System.Web.ClientServices
程序集:
System.Web.Extensions.dll

表示使用表单身份验证为客户端应用程序服务进行身份验证的用户标识。

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 方法重新验证用户。 但是，如果身份验证服务器不可用，事件处理程序会将应用程序返回到脱机状态。

注意

RevalidateUser 方法仅供方便使用。 由于它没有返回值，因此无法指示重新验证是否失败。 例如，如果服务器上的用户凭据已更改，重新验证可能会失败。 在这种情况下，你可能想要包含在服务调用失败后显式验证用户的代码。 有关详细信息，请参阅 演练中的“访问 Web 设置”部分：使用客户端应用程序服务。

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 属性检索到的 IPrincipalIdentity 属性检索对当前 ClientFormsIdentity 实例的引用。 有关详细信息，请参阅 客户端应用程序服务。

通常，你将以 IIdentity 引用的形式访问 ClientFormsIdentity 对象，以避免对此类的直接依赖。 可以通过检查标识的 IIdentity.IsAuthenticated 属性来确定用户是否已进行身份验证。 但是，用户可以对 Windows 进行身份验证，但不适用于客户端应用程序服务。 若要确定用户是否对客户端应用程序服务进行身份验证，还应确认 IIdentity.AuthenticationType 属性值为“ClientForms”。

必须使用显式 ClientFormsIdentity 引用来调用 RevalidateUser 方法，该方法不是由 IIdentity 接口定义的。

构造函数

ClientFormsIdentity(String, String, MembershipProvider, String, Boolean, CookieContainer)

初始化 ClientFormsIdentity 类的新实例。

属性

AuthenticationCookies

获取从身份验证服务检索到的 Cookie 的集合。
AuthenticationType

获取用于对用户进行身份验证的身份验证类型。
IsAuthenticated

获取一个值，该值指示用户是否已进行身份验证。
Name

获取用户的名称。
Provider

获取用于对用户进行身份验证的成员资格提供程序。

方法

Dispose()

释放 ClientFormsIdentity使用的所有资源。
Dispose(Boolean)

释放 ClientFormsIdentity 使用的非托管资源，并选择性地释放托管资源。
Equals(Object)

确定指定的对象是否等于当前对象。

(继承自 Object)
GetHashCode()

用作默认哈希函数。

(继承自 Object)
GetType()

获取当前实例的 Type。

(继承自 Object)
MemberwiseClone()

创建当前 Object的浅表副本。

(继承自 Object)
RevalidateUser()

使用缓存凭据以无提示方式对用户进行身份验证。
ToString()

返回一个表示当前对象的字符串。

(继承自 Object)

适用于

另请参阅