NetworkCredential Třída

Definice

Obor názvů:

System.Net

Sestavení:

System.dll

Poskytuje přihlašovací údaje pro schémata ověřování založená na heslech, jako jsou základní ověřování, digest, NTLM a 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

Dědičnost

Object

NetworkCredential

Implementuje

ICredentials ICredentialsByHost

Příklady

Následující příklad kódu přidruží NetworkCredential objekt k sadě identifikátorů URI (Uniform Resource Identifiers) v objektu CredentialCache. Potom předá CredentialCache objektu HttpClient , který ho používá k ověření požadavků na internetový server.

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

Poznámky

Třída NetworkCredential je základní třída, která poskytuje přihlašovací údaje v schématech ověřování založených na heslech, jako jsou základní, digest, NTLM a Kerberos. Třídy, které implementují ICredentials rozhraní, jako CredentialCache je třída, vrací NetworkCredential objekty.

Note

Na platformách Unix může použití ověřování NTLM vyžadovat instalaci modulu plug-in NTLM pro vrstvu GSSAPI používanou implementací. V distribucích Ubuntu se balíček nazývá gss-ntlmssp. Aplikace se také můžou rozhodnout pro spravovanou implementaci NTLM nastavením vlastnosti _UseManagedNtlm .csproj (pouze .NET 9 nebo novější) nebo nastavením přepínače System.Net.Security.UseManagedNtlm AppContext.

Na Windows vždy závisí ověřování NTLM a Negotiate (Kerberos) na GSSAPI operačního systému.

Tato třída nepodporuje metody ověřování založené na veřejných klíčích, jako je například ověřování klienta SSL (Secure Sockets Layer).

Konstruktory

Name	Description
NetworkCredential()	Inicializuje novou instanci NetworkCredential třídy.
NetworkCredential(String, SecureString, String)	Inicializuje novou instanci NetworkCredential třídy se zadaným uživatelským jménem, heslem a doménou.
NetworkCredential(String, SecureString)	Inicializuje novou instanci NetworkCredential třídy se zadaným uživatelským jménem a heslem.
NetworkCredential(String, String, String)	Inicializuje novou instanci NetworkCredential třídy se zadaným uživatelským jménem, heslem a doménou.
NetworkCredential(String, String)	Inicializuje novou instanci NetworkCredential třídy se zadaným uživatelským jménem a heslem.

Vlastnosti

Name	Description
Domain	Získá nebo nastaví název domény nebo počítače, který ověřuje přihlašovací údaje.
Password	Získá nebo nastaví heslo pro uživatelské jméno přidružené k přihlašovacím údajům.
SecurePassword	Získá nebo nastaví heslo jako SecureString instanci.
UserName	Získá nebo nastaví uživatelské jméno přidružené k přihlašovacím údajům.

Metody

Name	Description
Equals(Object)	Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object)
GetCredential(String, Int32, String)	Vrátí instanci NetworkCredential třídy pro zadaný typ hostitele, portu a ověřování.
GetCredential(Uri, String)	Vrátí instanci NetworkCredential třídy pro zadaný identifikátor URI (Uniform Resource Identifier) a typ ověřování.
GetHashCode()	Slouží jako výchozí funkce hash. (Zděděno od Object)
GetType()	Získá Type aktuální instance. (Zděděno od Object)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Object. (Zděděno od Object)
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)