NetworkCredential Класс

Определение

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

System.Net

Сборки:

netstandard.dll, 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объекте. Затем он передает CredentialCacheHttpClient объекту, который использует его для проверки подлинности запросов на интернет-сервер.

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 — это базовый класс, который предоставляет учетные данные в схемах проверки подлинности на основе паролей, таких как базовый, дайджест, NTLM и Kerberos. Классы, реализующие ICredentials интерфейс, такие как CredentialCache класс, возвращают NetworkCredential объекты.

Note

На платформах Unix для использования проверки подлинности NTLM может потребоваться установка подключаемого модуля NTLM для уровня GSSAPI, используемого реализацией. В дистрибутивах Ubuntu пакет вызывается gss-ntlmssp. Кроме того, приложения могут использовать управляемую реализацию NTLM, задав свойство _UseManagedNtlm .csproj (только .NET 9+) или установив параметр System.Net.Security.UseManagedNtlm AppContext.

При Windows проверка подлинности NTLM и Согласование (Kerberos) всегда зависит от GSSAPI операционной системы.

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

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

Имя	Описание
NetworkCredential()	Инициализирует новый экземпляр класса NetworkCredential.
NetworkCredential(String, SecureString, String)	Инициализирует новый экземпляр NetworkCredential класса с указанным именем пользователя, паролем и доменом.
NetworkCredential(String, SecureString)	Инициализирует новый экземпляр NetworkCredential класса с указанным именем пользователя и паролем.
NetworkCredential(String, String, String)	Инициализирует новый экземпляр NetworkCredential класса с указанным именем пользователя, паролем и доменом.
NetworkCredential(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)