IClientFormsAuthenticationCredentialsProvider.GetCredentials 方法

定義

命名空間:

System.Web.ClientServices.Providers

組件:

System.Web.Extensions.dll

擷取使用者認證。

public:
 System::Web::ClientServices::Providers::ClientFormsAuthenticationCredentials ^ GetCredentials();

public System.Web.ClientServices.Providers.ClientFormsAuthenticationCredentials GetCredentials ();

abstract member GetCredentials : unit -> System.Web.ClientServices.Providers.ClientFormsAuthenticationCredentials

Public Function GetCredentials () As ClientFormsAuthenticationCredentials

傳回

ClientFormsAuthenticationCredentials

使用者登入資訊。

範例

下列範例程式代碼示範如何實作 GetCredentials 方法。 在此範例中，方法 GetCredentials 是登入對話框類別的一部分。 這個方法會顯示對話框，然後傳回 ClientFormsAuthenticationCredentials 以使用者指定值初始化的實例。

public ClientFormsAuthenticationCredentials GetCredentials()
{
    if (this.ShowDialog() == DialogResult.OK)
    {
        return new ClientFormsAuthenticationCredentials(
            usernameTextBox.Text, passwordTextBox.Text,
            rememberMeCheckBox.Checked);
    }
    else
    {
        return null;
    }
}

Public Function GetCredentials() As  _
    ClientFormsAuthenticationCredentials Implements _
    IClientFormsAuthenticationCredentialsProvider.GetCredentials

    If Me.ShowDialog() = DialogResult.OK Then
        Return New ClientFormsAuthenticationCredentials( _
            UsernameTextBox.Text, PasswordTextBox.Text, _
            rememberMeCheckBox.Checked)
    Else
        Return Nothing
    End If

End Function

備註

搭配用戶端應用程式服務使用窗體驗證時，您可以將使用者名稱和密碼傳遞至 ValidateUser 方法。 您也可以傳遞空字串或 null 做為使用認證提供者的參數。 認證提供者是您在應用程式組態中所提供和指定的類別。 認證提供者類別必須實作 IClientFormsAuthenticationCredentialsProvider 介面，其具有稱為 GetCredentials的單一方法。 典型的 GetCredentials 方法實作會顯示對話框來擷取用戶輸入。 您可透過使用認證提供者在多個應用程式之間分享單一登入對話方塊。

另請參閱

• ClientFormsAuthenticationMembershipProvider
• ValidateUser(String, String)
• ClientFormsAuthenticationCredentials
• 用戶端應用程式服務
• 如何：設定用戶端應用程式服務
• 如何：使用用戶端應用程式服務實作使用者登入和註銷