WebClient.Credentials Свойство

Определение

Пространство имен:

System.Net

Сборка:

System.Net.WebClient.dll

Исходный код:

WebClient.cs

Возвращает или задает сетевые учетные данные, отправляемые узлу и используемые для проверки подлинности запроса.

public:
 property System::Net::ICredentials ^ Credentials { System::Net::ICredentials ^ get(); void set(System::Net::ICredentials ^ value); };

public System.Net.ICredentials? Credentials { get; set; }

member this.Credentials : System.Net.ICredentials with get, set

Public Property Credentials As ICredentials

Значение свойства

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 

Комментарии

Осторожность

WebRequest, HttpWebRequest, ServicePointи WebClient устарели, и их не следует использовать для новой разработки. Вместо этого используйте HttpClient.

Свойство Credentials содержит учетные данные проверки подлинности, используемые для доступа к ресурсу на узле. В большинстве клиентских сценариев следует использовать DefaultCredentials, которые являются учетными данными пользователя, вошедшего в систему. Для этого задайте для свойства UseDefaultCredentials значение true вместо задания этого свойства.

Если класс WebClient используется в приложении среднего уровня, например в приложении ASP.NET, DefaultCredentials принадлежат учетной записи, на которой выполняется страница ASP (учетные данные на стороне сервера). Как правило, это свойство присваивается учетным данным клиента, от имени которого выполняется запрос.

По соображениям безопасности при автоматическом выполнении перенаправления сохраните учетные данные, которые необходимо включить в перенаправление в CredentialCache, и назначьте его этому свойству. Это свойство будет автоматически установлено на null при перенаправлении, если оно содержит что-либо, кроме CredentialCache. Если это значение свойства будет автоматически задано для null в этих условиях, учетные данные не отправляются в любое непреднамеренное назначение.

См. также раздел

• NetworkCredential
• CredentialCache
• Credentials