ClientWindowsAuthenticationMembershipProvider 類別

定義

命名空間:

System.Web.ClientServices.Providers

組件:

System.Web.Extensions.dll

使用用戶端應用程式服務啟用 Windows 驗證。

public ref class ClientWindowsAuthenticationMembershipProvider : System::Web::Security::MembershipProvider

public class ClientWindowsAuthenticationMembershipProvider : System.Web.Security.MembershipProvider

type ClientWindowsAuthenticationMembershipProvider = class
    inherit MembershipProvider

Public Class ClientWindowsAuthenticationMembershipProvider
Inherits MembershipProvider

繼承

Object

ProviderBase

MembershipProvider

ClientWindowsAuthenticationMembershipProvider

範例

下列範例程式代碼示範如何使用此方法來使用 Windows 驗證來驗證使用者。 在此範例中，staticMembership.Provider 屬性的值會轉換成 ClientWindowsAuthenticationMembershipProvider 實例。 這可確保如果您不小心使用其他成員資格提供者來測試此程式代碼，則會擲回 NullReferenceException。

private bool ValidateUsingWindowsAuthentication()
{
    ClientWindowsAuthenticationMembershipProvider authProvider =
        System.Web.Security.Membership.Provider as
        ClientWindowsAuthenticationMembershipProvider;

    // Call ValidateUser and pass null values for the parameters.
    // This call always returns true.
    return authProvider.ValidateUser(null, null);
}

Private Function ValidateUsingWindowsAuthentication() As Boolean

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

    ' Call ValidateUser and pass Nothing for the parameters.
    ' This call always returns true.
    Return authProvider.ValidateUser(Nothing, Nothing)

End Function

備註

您可以使用用戶端應用程式服務，使用 Windows 驗證來驗證使用者。 若要啟用 Windows 驗證，您可以將應用程式設定為使用 ClientWindowsAuthenticationMembershipProvider 類別。

設定之後，您可以呼叫 staticMembership.ValidateUser 方法來驗證使用者。 Membership.ValidateUser 方法會在內部呼叫 ValidateUser 方法。

ClientWindowsAuthenticationMembershipProvider.ValidateUser 方法會自動驗證目前的使用者，並將 staticThread.CurrentPrincipal 屬性設定為包含目前 WindowsIdentity的 ClientRolePrincipal 物件。 如果應用程式已設定 ClientRoleProvider，您可以使用 ClientRolePrincipal 物件，從角色服務擷取使用者角色資訊。

您可以透過 staticMembership.Provider 屬性擷取目前 ClientWindowsAuthenticationMembershipProvider 實例的參考。 您可以使用成員資格提供者參考直接呼叫 ClientWindowsAuthenticationMembershipProvider.ValidateUser 方法。 此外，您將需要成員資格提供者參考來呼叫 Logout 方法，這在 MembershipProvider 基類中無法使用。

建構函式

ClientWindowsAuthenticationMembershipProvider()

初始化 ClientWindowsAuthenticationMembershipProvider 類別的新實例。

屬性

ApplicationName	這個類別不會使用這個屬性。
Description	取得簡短且易記的描述，適合顯示在系統管理工具或其他使用者介面中。 (繼承來源 ProviderBase)
EnablePasswordReset	這個類別不會使用這個屬性。
EnablePasswordRetrieval	這個類別不會使用這個屬性。
MaxInvalidPasswordAttempts	這個類別不會使用這個屬性。
MinRequiredNonAlphanumericCharacters	這個類別不會使用這個屬性。
MinRequiredPasswordLength	這個類別不會使用這個屬性。
Name	取得組態期間用來參考提供者的易記名稱。 (繼承來源 ProviderBase)
PasswordAttemptWindow	這個類別不會使用這個屬性。
PasswordFormat	這個類別不會使用這個屬性。
PasswordStrengthRegularExpression	這個類別不會使用這個屬性。
RequiresQuestionAndAnswer	這個類別不會使用這個屬性。
RequiresUniqueEmail	這個類別不會使用這個屬性。

方法

ChangePassword(String, String, String)	這個類別不會使用這個方法。
ChangePasswordQuestionAndAnswer(String, String, String, String)	這個類別不會使用這個方法。
CreateUser(String, String, String, String, String, Boolean, Object, MembershipCreateStatus)	這個類別不會使用這個方法。
DecryptPassword(Byte[])	解密加密的密碼。 (繼承來源 MembershipProvider)
DeleteUser(String, Boolean)	這個類別不會使用這個方法。
EncryptPassword(Byte[])	加密密碼。 (繼承來源 MembershipProvider)
EncryptPassword(Byte[], MembershipPasswordCompatibilityMode)	使用指定的密碼相容性模式加密指定的密碼。 (繼承來源 MembershipProvider)
Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
FindUsersByEmail(String, Int32, Int32, Int32)	這個類別不會使用這個方法。
FindUsersByName(String, Int32, Int32, Int32)	這個類別不會使用這個方法。
GetAllUsers(Int32, Int32, Int32)	這個類別不會使用這個方法。
GetHashCode()	做為預設哈希函式。 (繼承來源 Object)
GetNumberOfUsersOnline()	這個類別不會使用這個方法。
GetPassword(String, String)	這個類別不會使用這個方法。
GetType()	取得目前實例的 Type。 (繼承來源 Object)
GetUser(Object, Boolean)	這個類別不會使用這個方法。
GetUser(String, Boolean)	這個類別不會使用這個方法。
GetUserNameByEmail(String)	這個類別不會使用這個方法。
Initialize(String, NameValueCollection)	初始化組態產生器。 (繼承來源 ProviderBase)
Logout()	註銷使用者。
MemberwiseClone()	建立目前 Object的淺層複本。 (繼承來源 Object)
OnValidatingPassword(ValidatePasswordEventArgs)	如果已定義事件處理程式，則引發 ValidatingPassword 事件。 (繼承來源 MembershipProvider)
ResetPassword(String, String)	這個類別不會使用這個方法。
ToString()	傳回表示目前 物件的字串。 (繼承來源 Object)
UnlockUser(String)	這個類別不會使用這個方法。
UpdateUser(MembershipUser)	這個類別不會使用這個方法。
ValidateUser(String, String)	使用操作系統所提供的身分識別，自動驗證目前的使用者。

事件

ValidatingPassword

發生於使用者建立、變更密碼或重設密碼時。 (繼承來源 MembershipProvider)

另請參閱

• ValidateUser(String, String)
• ValidateUser(String, String)
• CurrentPrincipal
• ClientRolePrincipal
• WindowsIdentity
• ClientRoleProvider
• Provider
• Logout()
• 用戶端應用程式服務
• 如何：設定用戶端應用程式服務