WebProxy.UseDefaultCredentials 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 um valor Boolean que controla se o DefaultCredentials é enviado com solicitações.
public:
property bool UseDefaultCredentials { bool get(); void set(bool value); };public bool UseDefaultCredentials { get; set; }member this.UseDefaultCredentials : bool with get, setPublic Property UseDefaultCredentials As BooleanValor da propriedade
true se as credenciais padrão forem usadas; caso contrário, false. O valor padrão é false.
Exceções
Você tentou definir essa propriedade quando a propriedade Credentials contém credenciais diferentes das credenciais padrão.
Comentários
Defina essa propriedade como true quando as solicitações feitas por esse WebProxy objeto devem, se solicitadas pelo servidor, serem autenticadas usando as credenciais do usuário conectado no momento. Para aplicativos cliente, esse é o comportamento desejado na maioria dos cenários. Para aplicativos de camada intermediária, como aplicativos ASP.NET, em vez de usar essa propriedade, você normalmente definiria a Credentials propriedade como as credenciais do cliente em cujo nome a solicitação é feita.
A tabela a seguir mostra o efeito de definir o UseDefaultCredentials valor, com base no valor da Credentials propriedade .
| Credentials valor | UseDefaultCredentials valor | Efeito |
|---|---|---|
| DefaultCredentials | true |
Nenhum efeito. |
| DefaultCredentials | false |
Credentials é definido como null. |
null |
true |
Credentials é definido como DefaultCredentials. |
Qualquer valor diferente de DefaultCredentials ou null |
true ou false |
A configuração UseDefaultCredentials gera uma exceção. |
Se UseDefaultCredentials for false, você poderá alterar a Credentials propriedade para qualquer credencial. Se UseDefaultCredentials for true, alterar a Credentials propriedade de DefaultCredentials (o valor definido quando a UseDefaultCredentials propriedade é definida como true) gerará uma exceção.
