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 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
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 como 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.
Aplica-se a
Confira também
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de