NetworkCredential Класс

Определение

Пространство имен:

System.Net

Сборка:

System.Net.Primitives.dll

Исходный код:

NetworkCredential.cs

Предоставляет учетные данные для схем проверки подлинности на основе пароля, таких как обычная или дайджест-проверка подлинности либо проверка подлинности NTLM или 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

Наследование

Object

NetworkCredential

Реализации

ICredentials ICredentialsByHost

Примеры

В следующем примере кода объект связывается NetworkCredential с набором универсальных идентификаторов ресурсов (URI) в CredentialCache. Затем он передает CredentialCache объекту HttpClient , который использует его для проверки подлинности запросов к интернет-серверу.

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

Комментарии

Класс NetworkCredential является базовым классом, который предоставляет учетные данные в схемах проверки подлинности на основе пароля, таких как Basic, digest, NTLM и Kerberos. Классы, реализующие ICredentials интерфейс , такие как CredentialCache класс , возвращают NetworkCredential объекты.

Этот класс не поддерживает методы проверки подлинности на основе открытого ключа, такие как проверка подлинности клиента SSL.

Конструкторы

NetworkCredential()	Инициализирует новый экземпляр класса NetworkCredential.
NetworkCredential(String, SecureString)	Инициализирует новый экземпляр класса NetworkCredential с заданными значениями пароля и имени пользователя.
NetworkCredential(String, SecureString, String)	Инициализирует новый экземпляр класса NetworkCredential с заданными значениями имени пользователя, пароля и домена.
NetworkCredential(String, String)	Инициализирует новый экземпляр класса NetworkCredential с заданными значениями пароля и имени пользователя.
NetworkCredential(String, String, String)	Инициализирует новый экземпляр класса NetworkCredential с заданными значениями имени пользователя, пароля и домена.

Свойства

Domain	Возвращает или устанавливает имя домена или компьютера, проверяющего учетные данные.
Password	Возвращает или задает пароль для имени пользователя, связанного с учетными данными.
SecurePassword	Получает или задает пароль в виде экземпляра SecureString.
UserName	Возвращает или задает имя пользователя, связанное с учетными данными.

Методы

Equals(Object)	Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object)
GetCredential(String, Int32, String)	Возвращает экземпляр класса NetworkCredential для заданных узла, порта и типа проверки подлинности.
GetCredential(Uri, String)	Возвращает экземпляр класса NetworkCredential, связанный с указанным URI и типом проверки подлинности.
GetHashCode()	Служит хэш-функцией по умолчанию. (Унаследовано от Object)
GetType()	Возвращает объект Type для текущего экземпляра. (Унаследовано от Object)
MemberwiseClone()	Создает неполную копию текущего объекта Object. (Унаследовано от Object)
ToString()	Возвращает строку, представляющую текущий объект. (Унаследовано от Object)