NetworkCredential クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
基本認証、ダイジェスト認証、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 内の一連の 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://zcusa.951200.xyz/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://zcusa.951200.xyz/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://zcusa.951200.xyz/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) |
適用対象
.NET