WebClient.Credentials Propriedade
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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, setPublic Property Credentials As ICredentialsValor da propriedade
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.
