AuthenticationManager.CredentialPolicy Propriedade

Definição

Namespace:

System.Net

Assembly:

System.Net.Requests.dll

Origem:

AuthenticationManager.cs

Obtém ou define a política de credencial a ser usada para solicitações de recurso que são feitas usando a classe HttpWebRequest.

public:
 static property System::Net::ICredentialPolicy ^ CredentialPolicy { System::Net::ICredentialPolicy ^ get(); void set(System::Net::ICredentialPolicy ^ value); };

public static System.Net.ICredentialPolicy? CredentialPolicy { get; set; }

static member CredentialPolicy : System.Net.ICredentialPolicy with get, set

Public Shared Property CredentialPolicy As ICredentialPolicy

Valor da propriedade

ICredentialPolicy

Um objeto que implementa a interface que determina se as ICredentialPolicy credenciais são enviadas com solicitações. O valor padrão é null.

Exemplos

O exemplo de código a seguir demonstra a definição da política de credencial.

static void UseIntranetCredentialPolicy()
{
   IntranetZoneCredentialPolicy^ policy = gcnew IntranetZoneCredentialPolicy;
   AuthenticationManager::CredentialPolicy = policy;
}

 public static void UseIntranetCredentialPolicy()
{
    IntranetZoneCredentialPolicy  policy = new IntranetZoneCredentialPolicy();
    AuthenticationManager.CredentialPolicy = policy;
}

Comentários

A política de credencial determina se as credenciais devem ser enviadas ao enviar uma solicitação para um recurso de rede, como o conteúdo de uma página da Web. Se as credenciais forem enviadas, os servidores que exigem autenticação de cliente poderão tentar autenticar o cliente quando a solicitação for recebida em vez de enviar uma resposta indicando que as credenciais do cliente são necessárias. Embora isso salve uma viagem de ida e volta para o servidor, isso deve ser equilibrado em relação ao risco de segurança inerente ao envio de credenciais pela rede. Quando o servidor de destino não exige autenticação de cliente, é melhor não enviar credenciais.

A política de credencial será chamada somente para solicitações que especificam credenciais ou usam um WebProxy objeto que especifica credenciais.