Udostępnij za pośrednictwem


NetworkCredential Klasa

Definicja

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 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
Dziedziczenie
NetworkCredential
Implementuje

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)

Dotyczy