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

Im folgenden Codebeispiel werden die System Anmelde Informationen des Benutzers verwendet, um eine Anforderung zu authentifizieren.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 Authentifizierungs Anmelde Informationen, die für den Zugriff auf eine Ressource auf einem Host verwendet werden.The Credentials property contains the authentication credentials used to access a resource on a host. In den meisten Client seitigen Szenarien sollten Sie den DefaultCredentialsverwenden, bei dem es sich um die Anmelde Informationen des aktuell angemeldeten Benutzers handelt.In most client-side scenarios, you should use the DefaultCredentials, which are the credentials of the currently logged on user. Legen Sie hierzu die UseDefaultCredentials -Eigenschaft auf true fest, anstatt diese Eigenschaft festzulegen.To do this, set the UseDefaultCredentials property to true instead of setting this property.

Wenn die WebClient Klasse in einer Anwendung der mittleren Ebene verwendet wird, z. b. eine ASP.net- DefaultCredentials Anwendung, gehört zum Konto, das die ASP-Seite (serverseitige Anmelde Informationen) verwendet.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 legen Sie diese Eigenschaft auf die Anmelde Informationen des Clients fest, in dessen Auftrag die Anforderung erfolgt.Typically, you would set this property to the credentials of the client on whose behalf the request is made.

Speichern Sie aus Sicherheitsgründen die Anmelde Informationen, die in der Umleitung CredentialCache enthalten sein sollen, und weisen Sie diese dieser Eigenschaft zu, wenn Sie automatisch Umleitungen befolgen.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 bei der Umleitung automatisch null auf festgelegt, wenn Sie etwas außer CredentialCacheeinem enthält.This property will automatically be set to null upon redirection if it contains anything except a CredentialCache. Wenn dieser Eigenschafts Wert automatisch unter diesen null Bedingungen auf festgelegt wird, wird verhindert, dass Anmelde Informationen an ein unbeabsichtigtes 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