WebClient.Credentials Свойство

Определение

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

System.Net

Сборки:

netstandard.dll, 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