WebRequest.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.
Quando é sobreposto numa classe descendente, obtém ou define as credenciais de rede usadas para autenticar o pedido com o recurso da Internet.
public:
virtual property System::Net::ICredentials ^ Credentials { System::Net::ICredentials ^ get(); void set(System::Net::ICredentials ^ value); };public virtual System.Net.ICredentials Credentials { get; set; }member this.Credentials : System.Net.ICredentials with get, setPublic Overridable Property Credentials As ICredentialsValor de Propriedade
An contendo ICredentials as credenciais de autenticação associadas ao pedido. A predefinição é null.
Exceções
Qualquer tentativa é feita para obter ou definir a propriedade quando a propriedade não é sobreposta numa classe descendente.
Exemplos
O exemplo seguinte define a Credentials propriedade usando as credenciais padrão do utilizador atual. Quando o pedido é feito, as credenciais armazenadas nesta propriedade são usadas para validar o cliente. Isto é idêntico a definir a UseDefaultCredentials propriedade para true.
// Create a request for the URL.
WebRequest request = WebRequest.Create ("http://www.contoso.com/default.html");
// If required by the server, set the credentials.
request.Credentials = CredentialCache.DefaultCredentials;
// Get the response.
HttpWebResponse response = (HttpWebResponse)request.GetResponse ();
' Create a request for the URL.
Dim request As WebRequest = WebRequest.Create("http://www.contoso.com/default.html")
' If required by the server, set the credentials.
request.Credentials = CredentialCache.DefaultCredentials
' Get the response.
Dim response As HttpWebResponse = CType(request.GetResponse(), HttpWebResponse)
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 necessárias para aceder ao recurso da Internet.
Note
A WebRequest aula é uma abstract aula. O comportamento real das WebRequest instâncias em tempo de execução é determinado pela classe descendente devolvida pelo WebRequest.Create método. Para mais informações sobre valores e exceções por defeito, consulte a documentação das classes descendentes, como HttpWebRequest e FileWebRequest.