NetworkCredential Klasse

Definition

Namespace:

System.Net

Assembly:

System.Net.Primitives.dll

Quelle:

NetworkCredential.cs

Stellt Anmeldeinformationen für kennwortbasierte Authentifizierungsschemas (wie etwa Standard-, Hashwert-, NTLM- und Kerberos-Authentifizierung) bereit.

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

Vererbung

Object

NetworkCredential

Implementiert

ICredentials ICredentialsByHost

Beispiele

Im folgenden Codebeispiel wird ein NetworkCredential -Objekt einem Satz von URIs (Uniform Resource Identifiers) in einem CredentialCachezugeordnet. Anschließend wird die CredentialCache an ein HttpClient -Objekt übergeben, das es verwendet, um Anforderungen an einen Internetserver zu authentifizieren.

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

Hinweise

Die NetworkCredential -Klasse ist eine Basisklasse, die Anmeldeinformationen in kennwortbasierten Authentifizierungsschemas wie basic, digest, NTLM und Kerberos bereitstellt. Klassen, die die ICredentials Schnittstelle implementieren, z. B. die CredentialCache -Klasse, geben Objekte zurück NetworkCredential .

Diese Klasse unterstützt keine auf öffentlichen Schlüsseln basierenden Authentifizierungsmethoden wie die SSL-Clientauthentifizierung (Secure Sockets Layer).

Konstruktoren

NetworkCredential()	Initialisiert eine neue Instanz der NetworkCredential-Klasse.
NetworkCredential(String, SecureString)	Initialisiert eine neue Instanz der NetworkCredential-Klasse mit dem angegebenen Benutzernamen und Kennwort.
NetworkCredential(String, SecureString, String)	Initialisiert eine neue Instanz der NetworkCredential-Klasse mit dem angegebenen Benutzernamen und Kennwort sowie der angegebenen Domäne.
NetworkCredential(String, String)	Initialisiert eine neue Instanz der NetworkCredential-Klasse mit dem angegebenen Benutzernamen und Kennwort.
NetworkCredential(String, String, String)	Initialisiert eine neue Instanz der NetworkCredential-Klasse mit dem angegebenen Benutzernamen und Kennwort sowie der angegebenen Domäne.

Eigenschaften

Domain	Ruft den Namen der Domäne bzw. des Computers ab, in der bzw. auf dem die Anmeldeinformationen geprüft werden, oder legt diesen fest.
Password	Ruft das Kennwort für den Benutzernamen ab, der den Anmeldeinformationen zugeordnet ist, oder legt dieses fest.
SecurePassword	Ruft das Kennwort als SecureString-Instanz ab oder legt es fest.
UserName	Ruft den Benutzernamen ab, der den Anmeldeinformationen zugeordnet ist, oder legt diesen fest.

Methoden

Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
GetCredential(String, Int32, String)	Gibt eine Instanz der NetworkCredential-Klasse für den angegebenen Host, den angegebenen Anschluss und den angegebenen Authentifizierungstyp zurück.
GetCredential(Uri, String)	Gibt eine Instanz der NetworkCredential-Klasse für den angegebenen URI (Uniform Resource Identifier) und den angegebenen Authentifizierungstyp zurück.
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)