NetworkCredential 类

定义

命名空间:

System.Net

程序集:

System.Net.Primitives.dll

Source:

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 ，该对象使用它对 Internet 服务器的请求进行身份验证。

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 是在基于密码的身份验证方案（如基本、摘要、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)	针对指定的统一资源标识符 (URI) 和身份验证类型返回 NetworkCredential 类的实例。
GetHashCode()	作为默认哈希函数。 (继承自 Object)
GetType()	获取当前实例的 Type。 (继承自 Object)
MemberwiseClone()	创建当前 Object 的浅表副本。 (继承自 Object)
ToString()	返回表示当前对象的字符串。 (继承自 Object)