WebRequest.Credentials Propiedad
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Cuando se reemplaza en una clase descendiente, obtiene o establece las credenciales de red usadas para autenticar la solicitud con el recurso de 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; }public virtual System.Net.ICredentials? Credentials { get; set; }member this.Credentials : System.Net.ICredentials with get, setPublic Overridable Property Credentials As ICredentialsValor de propiedad
Un ICredentials que contiene las credenciales de autenticación asociadas a la solicitud. El valor predeterminado es null.
Excepciones
Cualquier intento se realiza para obtener o establecer la propiedad, cuando la propiedad no se invalida en una clase descendiente.
Ejemplos
En el ejemplo siguiente se establece la propiedad Credentials mediante las credenciales predeterminadas del usuario actual. Cuando se realiza la solicitud, las credenciales almacenadas en esta propiedad se usan para validar el cliente. Esto es idéntico a establecer la propiedad UseDefaultCredentials en 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 = dynamic_cast<HttpWebResponse^>(request->GetResponse());
// 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)
Comentarios
Cautela
WebRequest, HttpWebRequest, ServicePointy WebClient están obsoletos y no debe usarlos para el nuevo desarrollo. Use HttpClient en su lugar.
La propiedad Credentials contiene las credenciales de autenticación necesarias para acceder al recurso de Internet.
Nota
La clase WebRequest es una clase abstract. El comportamiento real de las instancias de WebRequest en tiempo de ejecución viene determinado por la clase descendiente devuelta por el método WebRequest.Create. Para obtener más información sobre los valores predeterminados y las excepciones, consulte la documentación de las clases descendientes, como HttpWebRequest y FileWebRequest.
