WebClient.Credentials WebClient.Credentials WebClient.Credentials WebClient.Credentials Property

Definition

Ruft die Netzwerkanmeldeinformationen ab, die an den Host gesendet und für die Authentifizierung der Anforderung verwendet werden, oder legt diese fest.Gets or sets the network credentials that are sent to the host and used to authenticate the request.

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

Eine ICredentials-Schnittstelle mit den Anmeldeinformationen für die Authentifizierung der Anforderung.An ICredentials containing the authentication credentials for the request. Die Standardeinstellung ist null.The default is null.

Beispiele

Das folgende Codebeispiel verwendet die Anmeldeinformationen des Benutzers System zum Authentifizieren einer Anforderung.The following code example uses the user's system credentials to authenticate a request.

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 Anmeldeinformationen für die Authentifizierung verwendet, um den Zugriff auf eine Ressource auf einem Host.The Credentials property contains the authentication credentials used to access a resource on a host. In den meisten Szenarien für die clientseitige, verwenden Sie die DefaultCredentials, welche sind die Anmeldeinformationen des aktuell angemeldeten Benutzers.In most client-side scenarios, you should use the DefaultCredentials, which are the credentials of the currently logged on user. Zu diesem Zweck legen Sie die UseDefaultCredentials Eigenschaft true statt durch Festlegen dieser Eigenschaft.To do this, set the UseDefaultCredentials property to true instead of setting this property.

Wenn die WebClient Klasse wird in einer Anwendung auf mittlerer Ebene, z. B. eine ASP.NET-Anwendung verwendet die DefaultCredentials gehören zu dem Konto, unter der ASP-Seite (die serverseitige-Anmeldeinformationen).If the WebClient class is being used in a middle tier application, such as an ASP.NET application, the DefaultCredentials belong to the account running the ASP page (the server-side credentials). In der Regel würden Sie diese Eigenschaft auf die Anmeldeinformationen des Clients festlegen, in die Namen angefordert wird.Typically, you would set this property to the credentials of the client on whose behalf the request is made.

Aus Sicherheitsgründen bei umleitungen automatisch folgen, speichern Sie die Anmeldeinformationen, die Sie die Umleitung in enthalten sein sollen eine CredentialCache und weisen sie diese Eigenschaft.For security reasons, when automatically following redirects, store the credentials that you want to be included in the redirect in a CredentialCache and assign it to this property. Diese Eigenschaft wird automatisch festgelegt werden, um null bei der Umleitung, wenn sie nichts außer enthält eine CredentialCache.This property will automatically be set to null upon redirection if it contains anything except a CredentialCache. Dass der Wert dieser Eigenschaft auf automatisch festgelegt werden null unter diesen Bedingungen verhindert, dass Anmeldeinformationen in einem nicht beabsichtigten Ziel gesendet werden.Having this property value be automatically set to null under those conditions prevents credentials from being sent to any unintended destination.

Gilt für:

Siehe auch