WebClient.Credentials Proprietà

  • Riferimento

Definizione

Spazio dei nomi:
System.Net
Assembly:
System.Net.WebClient.dll
Assembly:
System.dll
Assembly:
netstandard.dll
Origine:
WebClient.cs
Origine:
WebClient.cs
Origine:
WebClient.cs

Ottiene o imposta le credenziali di rete inviate all'host e usate per autenticare la richiesta.

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à

ICredentials

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

Esempio

Nell'esempio di codice seguente vengono usate 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

Cautela

WebRequest, HttpWebRequest, ServicePointe WebClient sono obsoleti e non è consigliabile usarli per nuovi sviluppi. Usare invece HttpClient.

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

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

Per motivi di sicurezza, quando si seguono automaticamente i reindirizzamenti, archiviare le credenziali che si desidera includere nel reindirizzamento in un CredentialCache e assegnarlo a questa proprietà. Questa proprietà verrà impostata automaticamente su null al reindirizzamento se contiene elementi ad eccezione di un CredentialCache. L'impostazione automatica di questo valore della proprietà su null in tali condizioni impedisce l'invio delle credenziali a qualsiasi destinazione imprevista.

Si applica a

Vedi anche