NetworkCredential Sınıf

Tanım

Ad Alanı:

System.Net

Bütünleştirilmiş Kodlar:

netstandard.dll, 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 bir NetworkCredential nesneyi tekdüzen Kaynak Tanımlayıcıları (URI) CredentialCachekümesiyle ilişkilendirir. Daha sonra bir nesneye CredentialCache iletir HttpClient ve bunu kullanarak bir İnternet sunucusuna yönelik isteklerin kimliğini doğrular.

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 arabirimini ICredentials uygulayan sınıflar CredentialCache nesneleri döndürür NetworkCredential .

Note

Unix platformlarında NTLM kimlik doğrulamasının kullanılması, uygulama tarafından kullanılan GSSAPI katmanı için NTLM eklentisinin yüklenmesini gerektirebilir. Ubuntu dağıtımlarında paket olarak adlandırılır gss-ntlmssp. Alternatif olarak, uygulamalar _UseManagedNtlm .csproj özelliğini ayarlayarak (yalnızca 9+ .NET) veya System.Net.Security.UseManagedNtlm AppContext anahtarını ayarlayarak NTLM'nin yönetilen uygulamasını seçebilir.

Windows NTLM ve Negotiate (Kerberos) kimlik doğrulaması her zaman işletim sisteminin GSSAPI'sine bağlıdır.

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

Name	Description
NetworkCredential()	NetworkCredential sınıfının yeni bir örneğini 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, SecureString)	Sınıfın NetworkCredential yeni bir örneğini belirtilen kullanıcı adı ve parolayla 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.
NetworkCredential(String, String)	Sınıfın NetworkCredential yeni bir örneğini belirtilen kullanıcı adı ve parolayla başlatır.

Özellikler

Name	Description
Domain	Kimlik bilgilerini doğrulayan etki alanı veya bilgisayar adını alır veya ayarlar.
Password	Kimlik bilgileriyle ilişkilendirilmiş 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

Name	Description
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()	Geçerli örneğin Type alır. (Devralındığı yer: Object)
MemberwiseClone()	Geçerli Objectbasit bir kopyasını oluşturur. (Devralındığı yer: Object)
ToString()	Geçerli nesneyi temsil eden bir dize döndürür. (Devralındığı yer: Object)