Compartilhar via

WebClient.Credentials Propriedade

  • Referência

Definição

Namespace:
System.Net
Assembly:
System.Net.WebClient.dll
Assembly:
System.dll
Assembly:
netstandard.dll
Origem:
WebClient.cs
Origem:
WebClient.cs
Origem:
WebClient.cs

Obtém ou define as credenciais de rede que são enviadas para o 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; }
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 da 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

Cuidado

WebRequest, HttpWebRequest, ServicePointe WebClient estão obsoletos e você não deve usá-los para um novo desenvolvimento. Em vez disso, use HttpClient.

A propriedade Credentials 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 propriedade UseDefaultCredentials como true em vez de definir essa propriedade.

Se a classe WebClient 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. Fazer com que esse valor de propriedade seja automaticamente definido como null nessas condições impede que as credenciais sejam enviadas para qualquer destino não intencional.

Aplica-se a

Confira também