WebClient.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í.
Obtiene o establece las credenciales de red que se envían al host y se utilizan para autenticar la solicitud.
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 de propiedad
ICredentials que contiene las credenciales de autenticación para la solicitud. De manera predeterminada, es null
.
Ejemplos
En el ejemplo de código siguiente se usan las credenciales del sistema del usuario para autenticar una solicitud.
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
Comentarios
La Credentials propiedad contiene las credenciales de autenticación usadas para acceder a un recurso en un host. En la mayoría de los escenarios del lado cliente, debe usar , DefaultCredentialsque son las credenciales del usuario que ha iniciado sesión actualmente. Para ello, establezca la UseDefaultCredentials propiedad true
en en lugar de establecer esta propiedad.
Si la WebClient clase se usa en una aplicación de nivel intermedio, como una aplicación de ASP.NET, pertenece DefaultCredentials a la cuenta que ejecuta la página ASP (las credenciales del lado servidor). Normalmente, establecería esta propiedad en las credenciales del cliente en cuyo nombre se realiza la solicitud.
Por motivos de seguridad, cuando se siguen automáticamente las redirecciones, almacene las credenciales que desea incluir en el redireccionamiento en CredentialCache y asígnela a esta propiedad. Esta propiedad se establecerá null
automáticamente en tras el redireccionamiento si contiene algo excepto .CredentialCache Tener este valor de propiedad se establece null
automáticamente en en esas condiciones impide que las credenciales se envíen a cualquier destino no deseado.
Se aplica a
Consulte también
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente las Cuestiones de GitHub como mecanismo de retroalimentación para el contenido y lo sustituiremos por un nuevo sistema de retroalimentación. Para más información, consulta:Enviar y ver comentarios de