WebClient.Credentials Propiedad

Definición

Espacio de nombres:

System.Net

Ensamblado:

System.Net.WebClient.dll

Source:

WebClient.cs

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; }

member this.Credentials : System.Net.ICredentials with get, set

Public Property Credentials As ICredentials

Valor de propiedad

ICredentials

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, esta propiedad se establecería en las credenciales del cliente en cuyo nombre se realiza la solicitud.

Por motivos de seguridad, al seguir 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.

Consulte también

• NetworkCredential
• CredentialCache
• Credentials