WebClient.Credentials Propriedade

Definição

Namespace:

System.Net

Assembly:

System.Net.WebClient.dll

Origem:

WebClient.cs

Obtém ou define as credenciais de rede que são enviadas ao host e usadas para autenticar a solicitação.

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

Valor da propriedade

ICredentials

Um ICredentials que contém as credenciais de autenticação para a solicitação. O padrão é null.

Exemplos

O exemplo de código a seguir usa as credenciais do sistema do usuário para autenticar uma solicitação.

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 

Comentários

A Credentials propriedade contém as credenciais de autenticação usadas para acessar um recurso em um host. Na maioria dos cenários do lado do cliente, você deve usar o DefaultCredentials, que são as credenciais do usuário conectado no momento. Para fazer isso, defina a UseDefaultCredentials propriedade como true em vez de definir essa propriedade.

Se a WebClient classe estiver sendo usada em um aplicativo de camada intermediária, como um aplicativo ASP.NET, o DefaultCredentials pertencerá à conta que executa a página ASP (as credenciais do lado do servidor). Normalmente, você definiria essa propriedade para as credenciais do cliente em cujo nome a solicitação é feita.

Por motivos de segurança, ao seguir redirecionamentos automaticamente, armazene as credenciais que você deseja incluir no redirecionamento em um CredentialCache e atribua-as a essa propriedade. Essa propriedade será definida automaticamente como null após o redirecionamento se contiver algo, exceto um CredentialCache. Ter esse valor de propriedade definido automaticamente como null nessas condições impede que as credenciais sejam enviadas para qualquer destino não intencional.

Confira também

• NetworkCredential
• CredentialCache
• Credentials