WebClient.Credentials Proprietà

Definizione

Spazio dei nomi:

System.Net

Assembly:

System.Net.WebClient.dll

Origine:

WebClient.cs

Ottiene o imposta le credenziali di rete inviate all'host e utilizzate per l'autenticazione della richiesta.

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

Valore della proprietà

ICredentials

Un oggetto 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

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, che sono 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, l'appartenenza DefaultCredentials all'account che esegue la pagina ASP (le credenziali lato server). In genere, questa proprietà verrà impostata sulle credenziali del client per conto della richiesta.

Per motivi di sicurezza, quando si seguono automaticamente i reindirizzamenti, archiviare le credenziali da includere nel reindirizzamento in un CredentialCache oggetto e assegnarlo a questa proprietà. Questa proprietà verrà impostata automaticamente su null dopo il reindirizzamento se contiene qualsiasi elemento, ad eccezione di .CredentialCache Se questo valore della proprietà viene impostato automaticamente su null in queste condizioni, impedisce l'invio delle credenziali a qualsiasi destinazione non prevista.

Vedi anche

• NetworkCredential
• CredentialCache
• Credentials