NetworkCredential Klasa

Definicja

Przestrzeń nazw:

System.Net

Zestawy:

netstandard.dll, System.Net.Primitives.dll

Źródło:

NetworkCredential.cs

Dostarcza poświadczenia dla schematów uwierzytelniania opartych na hasłach, takich jak podstawowe, szyfrowane, NTLM i uwierzytelnianie Kerberos.

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

Dziedziczenie

Object

NetworkCredential

Implementuje

ICredentials ICredentialsByHost

Przykłady

Poniższy przykład kodu kojarzy NetworkCredential obiekt z zestawem identyfikatorów URI (Uniform Resource Identifiers) w obiekcie CredentialCache. Następnie przekazuje CredentialCache obiekt do HttpClient obiektu, który używa go do uwierzytelniania żądań na serwerze internetowym.

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
})

Uwagi

Klasa NetworkCredential jest klasą bazową, która dostarcza poświadczenia w schematach uwierzytelniania opartych na hasłach, takich jak podstawowe, szyfrowane, NTLM i Kerberos. Klasy implementujące ICredentials interfejs, takie jak CredentialCache klasa, zwracają NetworkCredential obiekty.

Note

Na platformach Unix użycie uwierzytelniania NTLM może wymagać zainstalowania wtyczki NTLM dla warstwy GSSAPI używanej przez implementację. W dystrybucjach systemu Ubuntu pakiet nosi nazwę gss-ntlmssp. Alternatywnie aplikacje mogą zdecydować się na zarządzaną implementację NTLM, ustawiając właściwość _UseManagedNtlm .csproj (tylko .NET 9+) lub ustawiając przełącznik System.Net.Security.UseManagedNtlm AppContext.

W przypadku Windows uwierzytelnianie NTLM i Negotiate (Kerberos) zawsze zależy od interfejsu GSSAPI systemu operacyjnego.

Ta klasa nie obsługuje metod uwierzytelniania opartych na kluczach publicznych, takich jak uwierzytelnianie klienta Secure Sockets Layer (SSL).

Konstruktory

Nazwa	Opis
NetworkCredential()	Inicjuje nowe wystąpienie klasy NetworkCredential.
NetworkCredential(String, SecureString, String)	Inicjuje nowe wystąpienie NetworkCredential klasy z określoną nazwą użytkownika, hasłem i domeną.
NetworkCredential(String, SecureString)	Inicjuje nowe wystąpienie NetworkCredential klasy z określoną nazwą użytkownika i hasłem.
NetworkCredential(String, String, String)	Inicjuje nowe wystąpienie NetworkCredential klasy z określoną nazwą użytkownika, hasłem i domeną.
NetworkCredential(String, String)	Inicjuje nowe wystąpienie NetworkCredential klasy z określoną nazwą użytkownika i hasłem.

Właściwości

Nazwa	Opis
Domain	Pobiera lub ustawia nazwę domeny lub komputera, która weryfikuje poświadczenia.
Password	Pobiera lub ustawia hasło dla nazwy użytkownika skojarzonej z poświadczeniami.
SecurePassword	Pobiera lub ustawia hasło jako SecureString wystąpienie.
UserName	Pobiera lub ustawia nazwę użytkownika skojarzona z poświadczeniami.

Metody

Nazwa	Opis
Equals(Object)	Określa, czy określony obiekt jest równy bieżącemu obiektowi. (Odziedziczone po Object)
GetCredential(String, Int32, String)	Zwraca wystąpienie klasy dla określonego NetworkCredential hosta, portu i typu uwierzytelniania.
GetCredential(Uri, String)	Zwraca wystąpienie NetworkCredential klasy dla określonego identyfikatora URI (Uniform Resource Identifier) i typu uwierzytelniania.
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetType()	Pobiera Type bieżącego wystąpienia. (Odziedziczone po Object)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Object. (Odziedziczone po Object)
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)