UserNamePasswordServiceCredential 類別

定義

命名空間:

System.ServiceModel.Security

組件:

System.ServiceModel.dll

表示類別，這個類別用於設定服務如何驗證採用使用者名稱/密碼驗證的使用者，以及設定登入權杖的快取。

public ref class UserNamePasswordServiceCredential sealed

public sealed class UserNamePasswordServiceCredential

type UserNamePasswordServiceCredential = class

Public NotInheritable Class UserNamePasswordServiceCredential

繼承

Object

UserNamePasswordServiceCredential

範例

下列範例會列印服務的 UserNamePasswordServiceCredential 屬性值。

// Create a service host.
Uri httpUri = new Uri("http://localhost/Calculator");
ServiceHost sh = new ServiceHost(typeof(Calculator), httpUri);

// Create a binding that uses a username/password credential.
WSHttpBinding b = new WSHttpBinding(SecurityMode.Message);
b.Security.Message.ClientCredentialType = MessageCredentialType.UserName;

// Add an endpoint.
sh.AddServiceEndpoint(typeof(ICalculator), b, "UserNamePasswordCalculator");

// Get a reference to the UserNamePasswordServiceCredential object.
UserNamePasswordServiceCredential unpCredential =
    sh.Credentials.UserNameAuthentication;
// Print out values.
Console.WriteLine("IncludeWindowsGroup: {0}",
    unpCredential.IncludeWindowsGroups);
Console.WriteLine("UserNamePasswordValidationMode: {0}",
    unpCredential.UserNamePasswordValidationMode);
Console.WriteLine("CachedLogonTokenLifetime.Minutes: {0}",
    unpCredential.CachedLogonTokenLifetime.Minutes );
Console.WriteLine("CacheLogonTokens: {0}",
    unpCredential.CacheLogonTokens );
Console.WriteLine("MaxCachedLogonTokens: {0}",
    unpCredential.MaxCachedLogonTokens );

Console.ReadLine();

' Create a service host.
Dim httpUri As New Uri("http://localhost/Calculator")
Dim sh As New ServiceHost(GetType(Calculator), httpUri)

' Create a binding that uses a username/password credential.
Dim b As New WSHttpBinding(SecurityMode.Message)
b.Security.Message.ClientCredentialType = MessageCredentialType.UserName

' Add an endpoint.
sh.AddServiceEndpoint(GetType(ICalculator), b, "UserNamePasswordCalculator")

' Get a reference to the UserNamePasswordServiceCredential object.
Dim unpCredential As UserNamePasswordServiceCredential = sh.Credentials.UserNameAuthentication
' Print out values.
Console.WriteLine("IncludeWindowsGroup: {0}", unpCredential.IncludeWindowsGroups)
Console.WriteLine("UserNamePasswordValidationMode: {0}", unpCredential.UserNamePasswordValidationMode)
Console.WriteLine("CachedLogonTokenLifetime.Minutes: {0}", unpCredential.CachedLogonTokenLifetime.Minutes)
Console.WriteLine("CacheLogonTokens: {0}", unpCredential.CacheLogonTokens)
Console.WriteLine("MaxCachedLogonTokens: {0}", unpCredential.MaxCachedLogonTokens)

Console.ReadLine()

備註

如果服務使用的繫結中沒有任何一個是針對使用者名稱/密碼驗證設定的，就會忽略這個類別的相關屬性。 這些屬性包括 CustomUserNamePasswordValidator、IncludeWindowsGroups、MembershipProvider 和 UserNamePasswordValidationMode 屬性。

如果服務使用的繫結中沒有任何一個是設定成針對使用者名稱/密碼使用 Windows 驗證，就會忽略與登錄權杖快取相關的設定。 這些設定包括 CachedLogonTokenLifetime、CacheLogonTokens 和 MaxCachedLogonTokens 屬性。

屬性

CachedLogonTokenLifetime	取得或設定對權杖進行快取的最大時間長度。
CacheLogonTokens	取得或設定值，這個值會指出是否要快取登入權杖。
CustomUserNamePasswordValidator	取得或設定自訂使用者名稱和密碼驗證程式。
IncludeWindowsGroups	取得或設定值，這個值會指出 Windows 群組是否包含在安全性內容中。
MaxCachedLogonTokens	取得或設定要快取之登入權杖的最大數目。
MembershipProvider	取得或設定成員資格提供者。
UserNamePasswordValidationMode	取得或設定驗證使用者名稱和密碼的方法。

方法

Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
GetHashCode()	做為預設雜湊函式。 (繼承來源 Object)
GetType()	取得目前執行個體的 Type。 (繼承來源 Object)
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
ToString()	傳回代表目前物件的字串。 (繼承來源 Object)