WebClient.Credentials Propriedade
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Obtém ou definem as credenciais de rede que são enviadas ao anfitrião e usadas para autenticar o pedido.
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, setPublic Property Credentials As ICredentialsValor de Propriedade
An contendo ICredentials as credenciais de autenticação do pedido. A predefinição é null.
Exemplos
O exemplo de código seguinte utiliza as credenciais do sistema do utilizador para autenticar um pedido.
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
Observações
Atenção
WebRequest, HttpWebRequest, ServicePoint, e WebClient são obsoletos, e não deves usá-los para novos desenvolvimentos. Utilize HttpClient em substituição.
A Credentials propriedade contém as credenciais de autenticação usadas para aceder a um recurso num host. Na maioria dos cenários do lado do cliente, deve usar os DefaultCredentials, que são as credenciais do utilizador atualmente logado. Para isso, defina a UseDefaultCredentials propriedade para true em vez de definir esta propriedade.
Se a classe WebClient estiver a ser usada numa aplicação de nível intermédio, como uma aplicação ASP.NET, o DefaultCredentials pertence à conta que executa a página ASP (as credenciais do lado do servidor). Normalmente, definiria esta propriedade para as credenciais do cliente em nome do qual o pedido é feito.
Por razões de segurança, ao seguir automaticamente os redirecionamentos, armazene as credenciais que quer que incluam no redirecionamento e CredentialCache atribua-as a essa propriedade. Esta propriedade será automaticamente definida como null ao redirecionar se contiver algo além de um CredentialCache. Ter este valor de propriedade automaticamente definido para null nessas condições impede que credenciais sejam enviadas para qualquer destino não pretendido.