NetworkCredential Osztály

Definíció

Névtér:

System.Net

Szerelvények:

netstandard.dll, System.Net.Primitives.dll

Forrás:

NetworkCredential.cs

Hitelesítő adatokat biztosít a jelszóalapú hitelesítési sémákhoz, például az alapszintű, a kivonatoló, az NTLM- és a Kerberos-hitelesítéshez.

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

Öröklődés

Object

NetworkCredential

Megvalósítás

ICredentials ICredentialsByHost

Példák

Az alábbi példakód egy NetworkCredential objektumot társít egy egységes erőforrás-azonosítók (URI-k) készletéhez egy CredentialCache. Ezután átadja az CredentialCache objektumot egy HttpClient objektumnak, amely arra használja, hogy hitelesítse a kéréseket egy internetkiszolgálón.

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

Megjegyzések

Az NetworkCredential osztály egy alaposztály, amely hitelesítő adatokat biztosít a jelszóalapú hitelesítési sémákban, például az alapszintű, a kivonatoló, az NTLM és a Kerberos rendszerekben. Az interfészt ICredentials megvalósító osztályok, például az CredentialCache osztály, objektumokat ad vissza NetworkCredential .

Note

Unix-platformokon az NTLM-hitelesítés használatához szükség lehet az NTLM beépülő modul telepítésére a implementáció által használt GSSAPI-réteghez. Ubuntu-disztribúciók esetén a csomag neve gss-ntlmssp. Másik lehetőségként az alkalmazások a _UseManagedNtlm .csproj tulajdonság beállításával (csak 9+ .NET) vagy a System.Net.Security.UseManagedNtlm AppContext kapcsoló beállításával is dönthetnek az NTLM felügyelt implementációja mellett.

A Windows az NTLM és az Egyeztetés (Kerberos) hitelesítés mindig az operációs rendszer GSSAPI-jától függ.

Ez az osztály nem támogatja a nyilvános kulcsalapú hitelesítési módszereket, például a Secure Sockets Layer (SSL) ügyfél-hitelesítést.

Konstruktorok

Name	Description
NetworkCredential()	Inicializálja a NetworkCredential osztály új példányát.
NetworkCredential(String, SecureString, String)	Inicializálja az NetworkCredential osztály új példányát a megadott felhasználónévvel, jelszóval és tartománnyal.
NetworkCredential(String, SecureString)	Inicializálja az osztály új példányát NetworkCredential a megadott felhasználónévvel és jelszóval.
NetworkCredential(String, String, String)	Inicializálja az NetworkCredential osztály új példányát a megadott felhasználónévvel, jelszóval és tartománnyal.
NetworkCredential(String, String)	Inicializálja az osztály új példányát NetworkCredential a megadott felhasználónévvel és jelszóval.

Tulajdonságok

Name	Description
Domain	Lekéri vagy beállítja azt a tartományt vagy számítógépnevet, amely ellenőrzi a hitelesítő adatokat.
Password	Lekéri vagy beállítja a hitelesítő adatokhoz társított felhasználónév jelszavát.
SecurePassword	Lekéri vagy beállítja a jelszót példányként SecureString .
UserName	Lekéri vagy beállítja a hitelesítő adatokhoz társított felhasználónevet.

Metódusok

Name	Description
Equals(Object)	Meghatározza, hogy a megadott objektum egyenlő-e az aktuális objektummal. (Öröklődés forrása Object)
GetCredential(String, Int32, String)	A megadott gazdagép, port és hitelesítési típus osztályának NetworkCredential egy példányát adja vissza.
GetCredential(Uri, String)	A megadott egységes erőforrás-azonosító (URI) és hitelesítési típus osztályának NetworkCredential egy példányát adja vissza.
GetHashCode()	Ez az alapértelmezett kivonatoló függvény. (Öröklődés forrása Object)
GetType()	Lekéri az Type aktuális példányt. (Öröklődés forrása Object)
MemberwiseClone()	Az aktuális Objectpéldány sekély másolatát hozza létre. (Öröklődés forrása Object)
ToString()	Az aktuális objektumot jelképező sztringet ad vissza. (Öröklődés forrása Object)