WebClient.Credentials Propriedade

  • Referência

Definição

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

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; }
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 as DefaultCredentialscredenciais 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, a DefaultCredentials conta que está executando 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 null nessas condições impede que as credenciais sejam enviadas para qualquer destino não intencional.

Aplica-se a

Confira também