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 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; }
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. 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 der Umleitung enthalten 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.
Gilt für:
Weitere Informationen
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Tickets als Feedbackmechanismus für Inhalte auslaufen lassen und es durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter:Einreichen und Feedback anzeigen für