Прочитать на английском

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


NetworkCredential Класс

Определение

Предоставляет учетные данные для схем проверки подлинности на основе пароля, таких как обычная или дайджест-проверка подлинности либо проверка подлинности NTLM или Kerberos.

C#
public class NetworkCredential : System.Net.ICredentials, System.Net.ICredentialsByHost
C#
public class NetworkCredential : System.Net.ICredentials
Наследование
NetworkCredential
Реализации

Примеры

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

C#
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
});

Комментарии

Класс 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)

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

Продукт Версии
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0