NetworkCredential Sınıf

Tanım

Ad Alanı:

System.Net

Bütünleştirilmiş Kod:

System.Net.Primitives.dll

Kaynak:

NetworkCredential.cs

Temel, özet, NTLM ve Kerberos kimlik doğrulaması gibi parola tabanlı kimlik doğrulama düzenleri için kimlik bilgileri sağlar.

public ref class NetworkCredential : System::Net::ICredentials, System::Net::ICredentialsByHost

public class NetworkCredential : System.Net.ICredentials, System.Net.ICredentialsByHost

type NetworkCredential = class
    interface ICredentials
    interface ICredentialsByHost

Public Class NetworkCredential
Implements ICredentials, ICredentialsByHost

Devralma

Object

NetworkCredential

Uygulamalar

ICredentials ICredentialsByHost

Örnekler

Aşağıdaki kod örneği, içindeki tekdüzen Kaynak Tanımlayıcıları (URI) kümesiyle bir NetworkCredentialCredentialCachenesneyi ilişkilendirir. Daha sonra bir nesneye HttpClient iletir CredentialCache ve bunu kullanarak bir İnternet sunucusuna yönelik isteklerin kimliğini doğrular.

NetworkCredential^ myCred = gcnew NetworkCredential(
   SecurelyStoredUserName,SecurelyStoredPassword,SecurelyStoredDomain );

CredentialCache^ myCache = gcnew CredentialCache;

myCache->Add( gcnew Uri( "http://www.contoso.com" ), "Basic", myCred );
myCache->Add( gcnew Uri( "http://app.contoso.com" ), "Basic", myCred );

// HttpClient lifecycle management best practices:
// https://learn.microsoft.com/dotnet/fundamentals/networking/http/httpclient-guidelines#recommended-use
HttpClientHandler^ handler = gcnew HttpClientHandler();
handler->Credentials = myCache;
HttpClient^ client = gcnew HttpClient(handler);

NetworkCredential myCred = new NetworkCredential(
    SecurelyStoredUserName,SecurelyStoredPassword,SecurelyStoredDomain);

CredentialCache myCache = new CredentialCache();

myCache.Add(new Uri("http://www.contoso.com"), "Basic", myCred);
myCache.Add(new Uri("http://app.contoso.com"), "Basic", myCred);

// HttpClient lifecycle management best practices:
// https://learn.microsoft.com/dotnet/fundamentals/networking/http/httpclient-guidelines#recommended-use
HttpClient client = new HttpClient(new HttpClientHandler
{
    Credentials = myCache
});

Dim myCred As New NetworkCredential(SecurelyStoredUserName, SecurelyStoredPassword, SecurelyStoredDomain)

Dim myCache As New CredentialCache()

myCache.Add(New Uri("http://www.contoso.com"), "Basic", myCred)
myCache.Add(New Uri("http://app.contoso.com"), "Basic", myCred)
       
' HttpClient lifecycle management best practices:
' https://learn.microsoft.com/dotnet/fundamentals/networking/http/httpclient-guidelines#recommended-use
Dim client As New HttpClient(New HttpClientHandler With
{
    .Credentials = myCache
})

Açıklamalar

NetworkCredential sınıfı, temel, özet, NTLM ve Kerberos gibi parola tabanlı kimlik doğrulama düzenlerinde kimlik bilgileri sağlayan bir temel sınıftır. sınıfı gibi CredentialCache arabirimini ICredentials uygulayan sınıflar nesneleri döndürürNetworkCredential.

Bu sınıf, Güvenli Yuva Katmanı (SSL) istemci kimlik doğrulaması gibi ortak anahtar tabanlı kimlik doğrulama yöntemlerini desteklemez.

Oluşturucular

NetworkCredential()	NetworkCredential sınıfının yeni bir örneğini başlatır.
NetworkCredential(String, SecureString)	Belirtilen kullanıcı adı ve parolayla sınıfının yeni bir örneğini NetworkCredential başlatır.
NetworkCredential(String, SecureString, String)	Belirtilen kullanıcı adı, parola ve etki alanı ile sınıfının yeni bir örneğini NetworkCredential başlatır.
NetworkCredential(String, String)	Belirtilen kullanıcı adı ve parolayla sınıfının yeni bir örneğini NetworkCredential başlatır.
NetworkCredential(String, String, String)	Belirtilen kullanıcı adı, parola ve etki alanı ile sınıfının yeni bir örneğini NetworkCredential başlatır.

Özellikler

Domain	Kimlik bilgilerini doğrulayan etki alanını veya bilgisayar adını alır veya ayarlar.
Password	Kimlik bilgileriyle ilişkili kullanıcı adının parolasını alır veya ayarlar.
SecurePassword	Parolayı örnek SecureString olarak alır veya ayarlar.
UserName	Kimlik bilgileriyle ilişkili kullanıcı adını alır veya ayarlar.

Yöntemler

Equals(Object)	Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler. (Devralındığı yer: Object)
GetCredential(String, Int32, String)	Belirtilen konak, bağlantı noktası ve kimlik doğrulama türü için sınıfının bir örneğini NetworkCredential döndürür.
GetCredential(Uri, String)	Belirtilen Tekdüzen Kaynak Tanımlayıcısı (URI) ve kimlik doğrulama türü için sınıfının bir örneğini NetworkCredential döndürür.
GetHashCode()	Varsayılan karma işlevi işlevi görür. (Devralındığı yer: Object)
GetType()	Type Geçerli örneğini alır. (Devralındığı yer: Object)
MemberwiseClone()	Geçerli Objectöğesinin sığ bir kopyasını oluşturur. (Devralındığı yer: Object)
ToString()	Geçerli nesneyi temsil eden dizeyi döndürür. (Devralındığı yer: Object)