WebClient.Credentials Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ruft die Netzwerkanmeldeinformationen ab, die an den Host gesendet und zum Authentifizieren 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; }public System.Net.ICredentials Credentials { get; set; }member this.Credentials : System.Net.ICredentials with get, setPublic Property Credentials As ICredentialsEigenschaftswert
Eine ICredentials, die die Authentifizierungsanmeldeinformationen für die Anforderung enthält. 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
Vorsicht
WebRequest, HttpWebRequest, ServicePointund WebClient sind veraltet, und Sie sollten sie nicht für die neue Entwicklung verwenden. Verwenden Sie stattdessen HttpClient.
Die eigenschaft Credentials 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 DefaultCredentialsverwenden, die die Anmeldeinformationen des aktuell angemeldeten Benutzers sind. Legen Sie dazu die UseDefaultCredentials-Eigenschaft auf true fest, anstatt diese Eigenschaft festzulegen.
Wenn die WebClient Klasse in einer Anwendung auf mittlerer Ebene verwendet wird, z. B. eine ASP.NET Anwendung, gehören die DefaultCredentials zu dem Konto, auf dem die ASP-Seite ausgeführt wird (die serverseitigen Anmeldeinformationen). In der Regel würden Sie diese Eigenschaft auf die Anmeldeinformationen des Clients festlegen, in dessen Auftrag die Anforderung gestellt wird.
Aus Sicherheitsgründen speichern Sie beim automatischen Folgen von Umleitungen die Anmeldeinformationen, die Sie in die Umleitung in einem CredentialCache einbeziehen möchten, und 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 automatisch auf null unter diesen Bedingungen festgelegt wird, wird verhindert, dass Anmeldeinformationen an ein unbeabsichtigtes Ziel gesendet werden.
