ClientCredentials 類別

定義

命名空間:

System.ServiceModel.Description

組件:

System.ServiceModel.Primitives.dll

套件:

System.ServiceModel.Primitives v8.0.0

來源:

ClientCredentials.cs

讓使用者設定可用於通訊之用戶端的用戶端和服務認證，以及服務認證驗證設定。

public ref class ClientCredentials : System::ServiceModel::Security::SecurityCredentialsManager, System::ServiceModel::Description::IEndpointBehavior

public class ClientCredentials : System.ServiceModel.Security.SecurityCredentialsManager, System.ServiceModel.Description.IEndpointBehavior

type ClientCredentials = class
    inherit SecurityCredentialsManager
    interface IEndpointBehavior

Public Class ClientCredentials
Inherits SecurityCredentialsManager
Implements IEndpointBehavior

繼承

Object

SecurityCredentialsManager

ClientCredentials

衍生

System.ServiceModel.Federation.WSTrustChannelClientCredentials

實作

IEndpointBehavior

範例

下列程式碼範例將示範如何覆寫這個類別以及實作您自己的自訂用戶端認證，其中包含自訂安全性權杖管理員。

重要

請注意，覆寫 CreateSecurityTokenManager 方法以建立自訂安全性權杖管理員是很重要的。 衍生自 ClientCredentialsSecurityTokenManager 的安全性權杖管理員， 必須傳回衍生自 SecurityTokenProvider 的自訂安全性權杖提供者，以建立實際的安全性權杖。 如果並未依照這個模式建立安全性權杖，應用程式的安全性就會有受攻擊的風險，特別是在提高權限時。 此編碼模式可確保快取通道處理站時，使用正確的認證。

public class MyClientCredentials : ClientCredentials
{
    string creditCardNumber;

    public MyClientCredentials()
    {
        // Perform client credentials initialization.
    }

    protected MyClientCredentials(MyClientCredentials other)
        : base(other)
    {
        // Clone fields defined in this class.
        this.creditCardNumber = other.creditCardNumber;
    }

    public string CreditCardNumber
    {
        get
        {
            return this.creditCardNumber;
        }
        set
        {
            if (value == null)
            {
                throw new ArgumentNullException("value");
            }
            this.creditCardNumber = value;
        }
    }

    public override SecurityTokenManager CreateSecurityTokenManager()
    {
        // Return your implementation of the SecurityTokenManager.
        return new MyClientCredentialsSecurityTokenManager(this);
    }

    protected override ClientCredentials CloneCore()
    {
        // Implement the cloning functionality.
        return new MyClientCredentials(this);
    }
}

Public Class MyClientCredentials
    Inherits ClientCredentials
    Private creditCardNumberValue As String

    Public Sub New() 
    
    End Sub
    
    ' Perform client credentials initialization.    
    Protected Sub New(ByVal other As MyClientCredentials) 
        MyBase.New(other)
        ' Clone fields defined in this class.
        Me.creditCardNumberValue = other.creditCardNumberValue
    
    End Sub

    Public Property CreditCardNumber() As String 
        Get
            Return Me.creditCardNumberValue
        End Get
        Set
            If value Is Nothing Then
                Throw New ArgumentNullException("value")
            End If
            Me.creditCardNumberValue = value
        End Set
    End Property

    Public Overrides Function CreateSecurityTokenManager() As SecurityTokenManager 
        ' Return your implementation of the SecurityTokenManager.
        Return New MyClientCredentialsSecurityTokenManager(Me)
    
    End Function
    
    Protected Overrides Function CloneCore() As ClientCredentials 
        ' Implement the cloning functionality.
        Return New MyClientCredentials(Me)
    
    End Function
End Class

備註

ClientCredentials 可透過 ClientCredentials 類別的 ClientBase<TChannel> 屬性存取。

ClientCredentials 物件會新增至 Behaviors 集合。 屬性 ClientCredentials 是已知設計 模式 (該 集合中專案) 的外觀。 這個類別中的大多數屬性都會傳回組成多數屬性的物件。 這些物件可以用於組態：當 get 物件之後，您就可以呼叫其成員，使用它來 set 屬性。

建構函式

ClientCredentials()	初始化 ClientCredentials 類別的新執行個體。
ClientCredentials(ClientCredentials)	這是複製建構函式。

屬性

ClientCertificate	取得您可以用來提供 X.509 憑證的物件，而該憑證將由用戶端用於向服務進行驗證。
HttpDigest	取得目前的 HTTP 摘要式認證。
ServiceCertificate	取得用於指定服務之 X.509 憑證的物件。
UserName	取得認證物件，您可以使用此物件來設定用戶端向服務驗證本身時所使用的使用者名稱和密碼。
Windows	取得物件，這個物件會用於控制用戶端在向服務驗證本身時所使用的 Windows 認證。

方法

ApplyClientBehavior(ServiceEndpoint, ClientRuntime)	將指定的用戶端行為套用至端點。
Clone()	建立這個 ClientCredentials 執行個體的新複本。
CloneCore()	建立這個 ClientCredentials 執行個體的新複本。
CreateSecurityTokenManager()	建立這個執行個體的安全性權杖管理員。 這個方法很少被明確呼叫；它主要是用於擴充性案例中，而且是由系統本身呼叫。
Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
GetHashCode()	做為預設雜湊函式。 (繼承來源 Object)
GetType()	取得目前執行個體的 Type。 (繼承來源 Object)
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
ToString()	傳回代表目前物件的字串。 (繼承來源 Object)

明確介面實作

IEndpointBehavior.AddBindingParameters(ServiceEndpoint, BindingParameterCollection)	將這個類別的執行個體新增至繫結參數集合。
IEndpointBehavior.ApplyDispatchBehavior(ServiceEndpoint, EndpointDispatcher)	實作端點上服務的修改或延伸。
IEndpointBehavior.Validate(ServiceEndpoint)	保留供未來使用。