NetworkCredential Klasa

Definicja

Przestrzeń nazw:

System.Net

Zestaw:

System.Net.Primitives.dll

Źródło:

NetworkCredential.cs

Udostępnia poświadczenia dla schematów uwierzytelniania opartych na hasłach, takich jak podstawowe, szyfrowe, NTLM i uwierzytelnianie 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

Dziedziczenie

Object

NetworkCredential

Implementuje

ICredentials ICredentialsByHost

Przykłady

Poniższy przykład kodu kojarzy NetworkCredential obiekt z zestawem identyfikatorów URI (Uniform Resource Identifiers) w obiekcie CredentialCache. Następnie przekazuje CredentialCache obiekt do HttpClient obiektu, który używa go do uwierzytelniania żądań na serwerze internetowym.

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

Uwagi

Klasa NetworkCredential jest klasą bazową, która dostarcza poświadczenia w schematach uwierzytelniania opartych na hasłach, takich jak podstawowe, szyfrowe, NTLM i Kerberos. Klasy implementujące ICredentials interfejs, takie jak CredentialCache klasa, zwracają NetworkCredential obiekty.

Ta klasa nie obsługuje metod uwierzytelniania opartych na kluczach publicznych, takich jak uwierzytelnianie klienta Secure Sockets Layer (SSL).

Konstruktory

NetworkCredential()	Inicjuje nowe wystąpienie klasy NetworkCredential.
NetworkCredential(String, SecureString)	Inicjuje NetworkCredential nowe wystąpienie klasy z określoną nazwą użytkownika i hasłem.
NetworkCredential(String, SecureString, String)	Inicjuje NetworkCredential nowe wystąpienie klasy z określoną nazwą użytkownika, hasłem i domeną.
NetworkCredential(String, String)	Inicjuje NetworkCredential nowe wystąpienie klasy z określoną nazwą użytkownika i hasłem.
NetworkCredential(String, String, String)	Inicjuje NetworkCredential nowe wystąpienie klasy z określoną nazwą użytkownika, hasłem i domeną.

Właściwości

Domain	Pobiera lub ustawia nazwę domeny lub komputera, która weryfikuje poświadczenia.
Password	Pobiera lub ustawia hasło dla nazwy użytkownika skojarzonej z poświadczeniami.
SecurePassword	Pobiera lub ustawia hasło jako SecureString wystąpienie.
UserName	Pobiera lub ustawia nazwę użytkownika skojarzona z poświadczeniami.

Metody

Equals(Object)	Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object)
GetCredential(String, Int32, String)	Zwraca wystąpienie NetworkCredential klasy dla określonego hosta, portu i typu uwierzytelniania.
GetCredential(Uri, String)	Zwraca wystąpienie NetworkCredential klasy dla określonego identyfikatora URI (Uniform Resource Identifier) i typu uwierzytelniania.
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetType()	Type Pobiera bieżące wystąpienie. (Odziedziczone po Object)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)