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 

Комментарии

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

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

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

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

• NetworkCredential
• CredentialCache
• Credentials