Sdílet prostřednictvím


NetworkCredential Třída

Definice

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 ref class NetworkCredential : System::Net::ICredentials
public class NetworkCredential : System.Net.ICredentials, System.Net.ICredentialsByHost
public class NetworkCredential : System.Net.ICredentials
type NetworkCredential = class
    interface ICredentials
    interface ICredentialsByHost
type NetworkCredential = class
    interface ICredentials
Public Class NetworkCredential
Implements ICredentials, ICredentialsByHost
Public Class NetworkCredential
Implements ICredentials
Dědičnost
NetworkCredential
Implementuje

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)

Platí pro