WebClient.Credentials プロパティ
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
ホストに送信され、要求を認証するために使用されるネットワーク資格情報を取得または設定します。
public:
property System::Net::ICredentials ^ Credentials { System::Net::ICredentials ^ get(); void set(System::Net::ICredentials ^ value); };
public System.Net.ICredentials? Credentials { get; set; }
public System.Net.ICredentials Credentials { get; set; }
member this.Credentials : System.Net.ICredentials with get, set
Public Property Credentials As ICredentials
プロパティ値
要求に使用する認証資格情報を格納する ICredentials。 既定値は、null
です。
例
次のコード例では、ユーザーのシステム資格情報を使用して要求を認証します。
int main()
{
try
{
WebClient^ client = gcnew WebClient;
client->Credentials = CredentialCache::DefaultCredentials;
array<Byte>^pageData = client->DownloadData( "http://www.contoso.com" );
String^ pageHtml = Encoding::ASCII->GetString( pageData );
Console::WriteLine( pageHtml );
}
catch ( WebException^ webEx )
{
Console::Write( webEx );
}
}
public static void Main()
{
try {
WebClient client = new WebClient();
client.Credentials = CredentialCache.DefaultCredentials;
Byte[] pageData = client.DownloadData("http://www.contoso.com");
string pageHtml = Encoding.ASCII.GetString(pageData);
Console.WriteLine(pageHtml);
} catch (WebException webEx) {
Console.Write(webEx.ToString());
}
}
Public Shared Sub Main()
Try
Dim client As New WebClient()
client.Credentials = CredentialCache.DefaultCredentials
Dim pageData As [Byte]() = client.DownloadData("http://www.contoso.com")
Dim pageHtml As String = Encoding.ASCII.GetString(pageData)
Console.WriteLine(pageHtml)
Catch webEx As WebException
Console.Write(webEx.ToString())
End Try
End Sub
注釈
プロパティには Credentials 、ホスト上のリソースにアクセスするために使用される認証資格情報が含まれています。 ほとんどのクライアント側のシナリオでは、 を使用 DefaultCredentialsする必要があります。これは、現在ログオンしているユーザーの資格情報です。 これを行うには、このプロパティを UseDefaultCredentials 設定する代わりに、 プロパティを に true
設定します。
クラスが WebClient 中間層アプリケーション (ASP.NET アプリケーションなど) で使用されている場合、 DefaultCredentials は ASP ページ (サーバー側の資格情報) を実行しているアカウントに属します。 通常、このプロパティは、要求の代わりに行われるクライアントの資格情報に設定します。
セキュリティ上の理由から、リダイレクトを自動的にフォローする場合は、リダイレクトに含める資格情報を に CredentialCache 格納し、このプロパティに割り当てます。 を除く何かを含む場合、このプロパティはリダイレクト時に自動的に CredentialCacheにnull
設定されます。 これらの条件下でこのプロパティ値を に自動的に null
設定すると、資格情報が意図しない宛先に送信されなくなります。
適用対象
こちらもご覧ください
.NET
フィードバック
https://aka.ms/ContentUserFeedback」を参照してください。
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「フィードバックの送信と表示