ClientFormsAuthenticationMembershipProvider.ValidateUser Yöntem

Başvuru

Tanım

Ad Alanı:: System.Web.ClientServices.Providers

Bütünleştirilmiş Kod:: System.Web.Extensions.dll

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

Belirtilen kimlik bilgilerini kullanarak kullanıcının kimliğini doğrular.

Aşırı Yüklemeler

ValidateUser(String, String)	Belirtilen kullanıcı adını ve parolayı kullanarak kullanıcının kimliğini doğrular.
ValidateUser(String, String, Boolean)	Belirtilen kullanıcı adını ve parolayı kullanarak kullanıcının kimliğini doğrular ve isteğe bağlı olarak parolanın karması yerel veri önbelleğinde depolanır.
ValidateUser(String, String, String)	Belirtilen kullanıcı adı ve parolayı kullanarak belirtilen hizmet URI'sinde bir kullanıcının kimliğini doğrular.

ValidateUser(String, String)

Belirtilen kullanıcı adını ve parolayı kullanarak kullanıcının kimliğini doğrular.

public:
 override bool ValidateUser(System::String ^ username, System::String ^ password);

public override bool ValidateUser (string username, string password);

override this.ValidateUser : string * string -> bool

Public Overrides Function ValidateUser (username As String, password As String) As Boolean

Parametreler

username: String

Kimlik doğrulaması yapmak veya Emptynull bu uygulamanın kullanmak üzere yapılandırıldığı uygulamadan IClientFormsAuthenticationCredentialsProvider kimlik bilgilerini almak için kullanıcının adı.

password: String

Kimlik doğrulaması için kullanıcının parolası.

Döndürülenler

Boolean

true kullanıcının kimliği doğrulandıysa; aksi takdirde , false.

Özel durumlar

WebException

Özellik IsOffline değeridir false ve üyelik sağlayıcısı kimlik doğrulama hizmetine erişemiyor.

Örnekler

Aşağıdaki örnek kod, bir IClientFormsAuthenticationCredentialsProvider uygulama kullanarak kullanıcıyı doğrulamak için bu yöntemin nasıl kullanılacağını gösterir. Bu örnek, uygulamanızı bir kimlik bilgisi sağlayıcısı kullanacak şekilde yapılandırmanızı gerektirir.

private bool ValidateUsingCredentialsProvider()
{
    bool isAuthorized = false;
    try
    {
        ClientFormsAuthenticationMembershipProvider authProvider =
            System.Web.Security.Membership.Provider as
            ClientFormsAuthenticationMembershipProvider;

        // Call ValidateUser with empty strings in order to display the 
        // login dialog box configured as a credentials provider.
        isAuthorized = authProvider.ValidateUser(String.Empty, String.Empty);
    }
    catch (System.Net.WebException)
    {
        MessageBox.Show("Unable to access the authentication service.",
            "Warning", MessageBoxButtons.OK, MessageBoxIcon.Warning);
    }
    if (!isAuthorized)
    {
        MessageBox.Show("Unable to authenticate.", "Not logged in", 
            MessageBoxButtons.OK, MessageBoxIcon.Error);
        Application.Exit();
    }
    return isAuthorized;
}

Private Function ValidateUsingCredentialsProvider() As Boolean

    Dim isAuthorized As Boolean = False

    Try

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

        ' Call ValidateUser with empty strings in order to display the 
        ' login dialog box configured as a credentials provider.
        isAuthorized = authProvider.ValidateUser(String.Empty, String.Empty)

    Catch ex As System.Net.WebException

        MessageBox.Show("Unable to access the authentication service.", _
            "Warning", MessageBoxButtons.OK, MessageBoxIcon.Warning)

    End Try

    If Not isAuthorized Then

        MessageBox.Show("Unable to authenticate.", "Not logged in", _
            MessageBoxButtons.OK, MessageBoxIcon.Error)
        Application.Exit()

    End If

    Return isAuthorized

End Function

Açıklamalar

Form kimlik doğrulaması, kullanıcının kimlik bilgilerini uygulamanız tarafından sağlanan oturum açma denetimleri aracılığıyla belirtmesini gerektirir. Kimlik bilgilerini alabilir ve yöntemine Membership.ValidateUser geçirebilirsiniz. Ayrıca boş dizeler geçirebilir veya null kimlik bilgileri sağlayıcısı kullanabilirsiniz.

Ayrıca bkz.

Şunlara uygulanır

ValidateUser(String, String, Boolean)

Belirtilen kullanıcı adını ve parolayı kullanarak kullanıcının kimliğini doğrular ve isteğe bağlı olarak parolanın karması yerel veri önbelleğinde depolanır.

public:
 bool ValidateUser(System::String ^ username, System::String ^ password, bool rememberMe);

public bool ValidateUser (string username, string password, bool rememberMe);

override this.ValidateUser : string * string * bool -> bool

Public Function ValidateUser (username As String, password As String, rememberMe As Boolean) As Boolean

Parametreler

username: String

Kimlik doğrulaması için kullanıcının adı.

password: String

Kimlik doğrulaması için kullanıcının parolası.

rememberMe: Boolean

true çevrimdışı kullanım ve kullanıcı kimlik doğrulaması tanımlama bilgisinin süresi dolduğunda otomatik yeniden kimlik doğrulaması için yerel veri önbelleğinde parola karması depolamak; false çevrimdışı oturum açmayı devre dışı bırakmak veya tanımlama bilgisinin süresi dolduğunda kullanıcıların yeniden kimlik doğrulamasını zorunlu kılma.

Döndürülenler

Boolean

true kullanıcının kimliği doğrulandıysa; aksi takdirde , false.

Özel durumlar

WebException

Özellik IsOffline değeridir false ve üyelik sağlayıcısı kimlik doğrulama hizmetine erişemiyor.

Örnekler

Aşağıdaki örnek kod, uygulama kodunuzda oturum açma denetimlerini kullanarak kullanıcıyı doğrulamak için bu yöntemin nasıl kullanılacağını gösterir. Bu örnek, adlı usernameTextBoxbir TextBox denetim, adlı bir TextBox denetim ve adlı passwordTextBoxrememberMeCheckBoxbir CheckBox denetim gerektirir.

private bool ValidateUsingLoginControls()
{
    bool isAuthorized = false;
    try
    {
        ClientFormsAuthenticationMembershipProvider authProvider =
            System.Web.Security.Membership.Provider as
            ClientFormsAuthenticationMembershipProvider;

        // Call ValidateUser with credentials retrieved from login controls.
        isAuthorized = authProvider.ValidateUser(usernameTextBox.Text,
            passwordTextBox.Text, rememberMeCheckBox.Checked);
    }
    catch (System.Net.WebException)
    {
        MessageBox.Show("Unable to access the authentication service.",
            "Warning", MessageBoxButtons.OK, MessageBoxIcon.Warning);
    }
    if (!isAuthorized)
    {
        MessageBox.Show("Unable to authenticate.", "Not logged in",
            MessageBoxButtons.OK, MessageBoxIcon.Error);
        Application.Exit();
    }
    return isAuthorized;
}

Private Function ValidateUsingLoginControls() As Boolean

    Dim isAuthorized As Boolean = False

    Try

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

        ' Call ValidateUser with credentials retrieved from login controls.
        isAuthorized = authProvider.ValidateUser(usernameTextBox.Text, _
            passwordTextBox.Text, rememberMeCheckBox.Checked)

    Catch ex As System.Net.WebException

        MessageBox.Show("Unable to access the authentication service.", _
            "Warning", MessageBoxButtons.OK, MessageBoxIcon.Warning)

    End Try

    If Not isAuthorized Then

        MessageBox.Show("Unable to authenticate.", "Not logged in", _
            MessageBoxButtons.OK, MessageBoxIcon.Error)
        Application.Exit()

    End If

    Return isAuthorized

End Function

Açıklamalar

Form kimlik doğrulamasını kullanarak kullanıcıları doğrulamak için istemci uygulama hizmetlerini kullanabilirsiniz. Kullanıcıları doğrulamak için genellikle dahili olarak yöntemini çağıran yöntemini çağırırsınız staticMembership.ValidateUser ClientFormsAuthenticationMembershipProvider.ValidateUser(String, String) . Alternatif olarak, yöntemini doğrudan çağırabilirsiniz ClientFormsAuthenticationMembershipProvider.ValidateUser . ve password değerlerine ek olarak bir rememberMe değer geçirmek için username bu aşırı yüklemeyi çağırabilirsiniz.

Ayrıca bkz.

Şunlara uygulanır

ValidateUser(String, String, String)

Belirtilen kullanıcı adı ve parolayı kullanarak belirtilen hizmet URI'sinde bir kullanıcının kimliğini doğrular.

public:
 static bool ValidateUser(System::String ^ username, System::String ^ password, System::String ^ serviceUri);

public static bool ValidateUser (string username, string password, string serviceUri);

static member ValidateUser : string * string * string -> bool

Public Shared Function ValidateUser (username As String, password As String, serviceUri As String) As Boolean

Parametreler

username: String

Kimlik doğrulaması için kullanıcının adı.

password: String

Kimlik doğrulaması için kullanıcının parolası.

serviceUri: String

Kullanılacak kimlik doğrulama hizmetinin URI'sini.

Döndürülenler

Boolean

true kullanıcının kimliği doğrulandıysa; aksi takdirde , false.

Özel durumlar

WebException

Özellik IsOffline değeridir false ve üyelik sağlayıcısı kimlik doğrulama hizmetine erişemiyor.

Örnekler

Aşağıdaki örnek kod, kullanıcıyı belirtilen bir konumdaki bir kimlik doğrulama hizmeti aracılığıyla doğrulamak için bu yöntemin nasıl kullanılacağını gösterir. Kullanıcı kimlik bilgileri, uygulama kodunuzdaki oturum açma denetimlerinden alınır. Bu örnekte adlı bir TextBox denetim ve adlı usernameTextBoxpasswordTextBoxbir TextBox denetim gerekir.

private bool ValidateUsingServiceUri(String serviceUri)
{
    bool isAuthorized = false;
    try
    {
        // Call the static overload of ValidateUser. Specify credentials 
        // retrieved from login controls and the service location.
        isAuthorized = 
            ClientFormsAuthenticationMembershipProvider.ValidateUser(
            usernameTextBox.Text, passwordTextBox.Text, serviceUri);
    }
    catch (System.Net.WebException)
    {
        MessageBox.Show("Unable to access the authentication service.",
            "Warning", MessageBoxButtons.OK, MessageBoxIcon.Warning);
    }
    if (!isAuthorized)
    {
        MessageBox.Show("Unable to authenticate.", "Not logged in",
            MessageBoxButtons.OK, MessageBoxIcon.Error);
        Application.Exit();
    }
    return isAuthorized;
}

Private Function ValidateUsingServiceUri(ByVal serviceUri As String) As Boolean

    Dim isAuthorized As Boolean = False

    Try

        ' Call the Shared overload of ValidateUser. Specify credentials 
        ' retrieved from login controls and the service location.
        isAuthorized = _
            ClientFormsAuthenticationMembershipProvider.ValidateUser( _
            usernameTextBox.Text, passwordTextBox.Text, serviceUri)

    Catch ex As System.Net.WebException

        MessageBox.Show("Unable to access the authentication service.", _
            "Warning", MessageBoxButtons.OK, MessageBoxIcon.Warning)

    End Try

    If Not isAuthorized Then

        MessageBox.Show("Unable to authenticate.", "Not logged in", _
            MessageBoxButtons.OK, MessageBoxIcon.Error)
        Application.Exit()

    End If

    Return isAuthorized

End Function

Açıklamalar

Form kimlik doğrulamasını kullanarak kullanıcıları doğrulamak için istemci uygulama hizmetlerini kullanabilirsiniz. Kullanıcıları doğrulamak için genellikle dahili olarak yöntemini çağıran yöntemini çağırırsınız staticMembership.ValidateUser ClientFormsAuthenticationMembershipProvider.ValidateUser . Alternatif olarak, yöntemini doğrudan çağırabilirsiniz ClientFormsAuthenticationMembershipProvider.ValidateUser . Parametresi tarafından serviceUri belirtilen konumdaki bir kimlik doğrulama hizmetine erişmek için bu aşırı yüklemeyi çağırabilirsiniz. Bu aşırı yüklemeyi kullanmak, özelliğini ayarlamaya ServiceUri ve aşırı yüklemeyi çağırmaya ValidateUser(String, String) alternatiftir.

Ayrıca bkz.

Şunlara uygulanır

Aracılığıyla paylaş

ClientFormsAuthenticationMembershipProvider.ValidateUser Yöntem

Tanım

Aşırı Yüklemeler

ValidateUser(String, String)

Parametreler

Döndürülenler

Özel durumlar

Örnekler

Açıklamalar

Ayrıca bkz.

Şunlara uygulanır

ValidateUser(String, String, Boolean)

Parametreler

Döndürülenler

Özel durumlar

Örnekler

Açıklamalar

Ayrıca bkz.

Şunlara uygulanır

ValidateUser(String, String, String)

Parametreler

Döndürülenler

Özel durumlar

Örnekler

Açıklamalar

Ayrıca bkz.

Şunlara uygulanır

Geri Bildirim

Ek kaynaklar