WebClient.Credentials プロパティ

定義

ホストに送信され、要求を認証するために使用されるネットワーク資格情報を取得または設定します。Gets or sets the network credentials that are sent to the host and used to authenticate the request.

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

要求に使用する認証資格情報を格納する ICredentialsAn ICredentials containing the authentication credentials for the request. 既定値は、null です。The default is null.

次のコード例では、ユーザーのシステム資格情報を使用して要求を認証します。The following code example uses the user's system credentials to authenticate a request.

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 ホスト上のリソースにアクセスするために使用される認証資格情報を格納します。The Credentials property contains the authentication credentials used to access a resource on a host. ほとんどのクライアント側のシナリオでは、現在ログオンしているユーザーの資格情報であるを使用する必要があり DefaultCredentials ます。In most client-side scenarios, you should use the DefaultCredentials, which are the credentials of the currently logged on user. これを行うには、 UseDefaultCredentials このプロパティを設定するのではなく、プロパティをに設定し true ます。To do this, set the UseDefaultCredentials property to true instead of setting this property.

WebClientASP.NET アプリケーションなどの中間層アプリケーションでクラスが使用されている場合、は DefaultCredentials ASP ページ (サーバー側の資格情報) を実行しているアカウントに属しています。If the WebClient class is being used in a middle tier application, such as an ASP.NET application, the DefaultCredentials belong to the account running the ASP page (the server-side credentials). 通常、このプロパティは、要求の発行元のクライアントの資格情報に設定します。Typically, you would set this property to the credentials of the client on whose behalf the request is made.

セキュリティ上の理由により、自動的にリダイレクトされる場合は、に追加する資格情報をに格納 CredentialCache し、このプロパティに割り当てます。For security reasons, when automatically following redirects, store the credentials that you want to be included in the redirect in a CredentialCache and assign it to this property. このプロパティにが null 含まれていない場合は、リダイレクト時に自動的にに設定され CredentialCache ます。This property will automatically be set to null upon redirection if it contains anything except a CredentialCache. このプロパティ値を自動的にに設定すると、 null 資格情報が意図しない宛先に送信されるのを防ぐことができます。Having this property value be automatically set to null under those conditions prevents credentials from being sent to any unintended destination.

適用対象

こちらもご覧ください