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://video2.skills-academy.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://video2.skills-academy.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://video2.skills-academy.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) |