WebClient.Credentials Proprietà

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

Valore della proprietà

Un oggetto ICredentials contenente le credenziali di autenticazione per la richiesta. Il valore predefinito è null.

Esempio

Nell'esempio di codice seguente vengono utilizzate le credenziali di sistema dell'utente per autenticare una richiesta.

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 

Commenti

La Credentials proprietà contiene le credenziali di autenticazione usate per accedere a una risorsa in un host. Nella maggior parte degli scenari lato client è consigliabile usare DefaultCredentials, ovvero le credenziali dell'utente attualmente connesso. A tale scopo, impostare la UseDefaultCredentials proprietà su true anziché impostare questa proprietà.

Se la WebClient classe viene usata in un'applicazione di livello intermedio, ad esempio un'applicazione ASP.NET, appartiene DefaultCredentials all'account che esegue la pagina ASP (credenziali lato server). In genere, è necessario impostare questa proprietà sulle credenziali del client per conto del quale viene effettuata la richiesta.

Per motivi di sicurezza, quando si seguono automaticamente i reindirizzamenti, archiviare le credenziali che si desidera includere nel reindirizzamento in un CredentialCache oggetto e assegnarlo a questa proprietà. Questa proprietà verrà impostata automaticamente su null al momento del reindirizzamento se contiene elementi tranne un oggetto CredentialCache. Se questo valore della proprietà viene impostato automaticamente su null in queste condizioni, le credenziali non vengono inviate a una destinazione imprevista.

Si applica a

Vedi anche

• NetworkCredential
• CredentialCache
• Credentials