NetworkCredential Třída

Definice

Obor názvů:

System.Net

Sestavení:

System.Net.Primitives.dll

Zdroj:

NetworkCredential.cs

Poskytuje přihlašovací údaje pro schémata ověřování založeného na heslech, jako je základní ověřování, ověřování hodnotou hash, protokolem NTLM a protokolem 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 Identifier) v objektu CredentialCache. Poté předá CredentialCache objektu , který ho HttpClient používá k ověřování požadavků na internetový server.

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

Poznámky

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

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

Konstruktory

NetworkCredential()	Inicializuje novou instanci NetworkCredential třídy .
NetworkCredential(String, SecureString)	Inicializuje novou instanci NetworkCredential třídy se zadaným uživatelským jménem a heslem.
NetworkCredential(String, SecureString, 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.
NetworkCredential(String, String, String)	Inicializuje novou instanci NetworkCredential třídy se zadaným uživatelským jménem, heslem a doménou.

Vlastnosti

Domain	Získá nebo nastaví název domény nebo počítače, který ověřuje pověření.
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

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ého hostitele, port a typ 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í hashovací funkce. (Zděděno od Object)
GetType()	Type Získá z aktuální instance. (Zděděno od Object)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object)
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)