Поделиться через


NetworkCredential Класс

Определение

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

Примеры

В следующем примере кода объект связывается 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)

Применяется к