WebClient.Credentials Eigenschaft

Definition

Namespace:

System.Net

Assembly:

System.Net.WebClient.dll

Quelle:

WebClient.cs

Ruft die Netzwerkanmeldeinformationen ab, die an den Host gesendet und für die Authentifizierung der Anforderung verwendet werden, oder legt diese fest.

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

Eigenschaftswert

ICredentials

Eine ICredentials-Schnittstelle mit den Anmeldeinformationen für die Authentifizierung der Anforderung. Der Standardwert ist null.

Beispiele

Im folgenden Codebeispiel werden die Systemanmeldeinformationen des Benutzers verwendet, um eine Anforderung zu authentifizieren.

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 

Hinweise

Die Credentials -Eigenschaft enthält die Authentifizierungsanmeldeinformationen, die für den Zugriff auf eine Ressource auf einem Host verwendet werden. In den meisten clientseitigen Szenarien sollten Sie die verwenden, bei der DefaultCredentialses sich um die Anmeldeinformationen des aktuell angemeldeten Benutzers handelt. Legen Sie dazu die UseDefaultCredentials Eigenschaft auf true fest, anstatt diese Eigenschaft festzulegen.

Wenn die WebClient -Klasse in einer Anwendung der mittleren Ebene verwendet wird, z. B. in einer ASP.NET-Anwendung, gehören die DefaultCredentials zu dem Konto, das die ASP-Seite ausführt (die serverseitigen Anmeldeinformationen). In der Regel legen Sie diese Eigenschaft auf die Anmeldeinformationen des Clients fest, in dessen Auftrag die Anforderung gestellt wird.

Speichern Sie aus Sicherheitsgründen beim automatischen Folgen von Umleitungen die Anmeldeinformationen, die Sie in die Umleitung einbeziehen möchten, und CredentialCache weisen Sie sie dieser Eigenschaft zu. Diese Eigenschaft wird bei der Umleitung automatisch auf null festgelegt, wenn sie etwas außer einem CredentialCacheenthält. Wenn dieser Eigenschaftswert unter diesen Bedingungen automatisch auf null festgelegt wird, wird verhindert, dass Anmeldeinformationen an ein unbeabsichtigtes Ziel gesendet werden.

Weitere Informationen

• NetworkCredential
• CredentialCache
• Credentials