NetworkCredential クラス

定義

名前空間:

System.Net

アセンブリ:

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 内の一連の Uniform Resource Identifier (URI) にオブジェクトを CredentialCache関連付けます。 次に、 オブジェクトに をHttpClient渡CredentialCacheします。これを使用して、インターネット サーバーへの要求を認証します。

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 します。

このクラスは、Secure Sockets Layer (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 (Uniform Resource Identifier) と認証の種類について、NetworkCredential クラスのインスタンスを返します。
GetHashCode()	既定のハッシュ関数として機能します。 (継承元 Object)
GetType()	現在のインスタンスの Type を取得します。 (継承元 Object)
MemberwiseClone()	現在の Object の簡易コピーを作成します。 (継承元 Object)
ToString()	現在のオブジェクトを表す文字列を返します。 (継承元 Object)