WebRequest.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.
Wenn sie in einer untergeordneten Klasse überschrieben werden, werden die Netzwerkanmeldeinformationen abgerufen oder festgelegt, die zum Authentifizieren der Anforderung mit der Internetressource verwendet werden.
public:
virtual property System::Net::ICredentials ^ Credentials { System::Net::ICredentials ^ get(); void set(System::Net::ICredentials ^ value); };public virtual System.Net.ICredentials Credentials { get; set; }public virtual System.Net.ICredentials? Credentials { get; set; }member this.Credentials : System.Net.ICredentials with get, setPublic Overridable Property Credentials As ICredentialsEigenschaftswert
Eine ICredentials, die die Authentifizierungsanmeldeinformationen enthält, die der Anforderung zugeordnet sind. Der Standardwert ist null.
Ausnahmen
Es wird versucht, die Eigenschaft abzurufen oder festzulegen, wenn die Eigenschaft nicht in einer untergeordneten Klasse überschrieben wird.
Beispiele
Im folgenden Beispiel wird die Credentials-Eigenschaft mithilfe der Standardanmeldeinformationen des aktuellen Benutzers festgelegt. Wenn die Anforderung gestellt wird, werden in dieser Eigenschaft gespeicherte Anmeldeinformationen verwendet, um den Client zu überprüfen. Dies ist identisch mit dem Festlegen der UseDefaultCredentials-Eigenschaft auf true.
// Create a request for the URL.
WebRequest^ request = WebRequest::Create( "http://www.contoso.com/default.html" );
// If required by the server, set the credentials.
request->Credentials = CredentialCache::DefaultCredentials;
// Get the response.
HttpWebResponse^ response = dynamic_cast<HttpWebResponse^>(request->GetResponse());
// Create a request for the URL.
WebRequest request = WebRequest.Create ("http://www.contoso.com/default.html");
// If required by the server, set the credentials.
request.Credentials = CredentialCache.DefaultCredentials;
// Get the response.
HttpWebResponse response = (HttpWebResponse)request.GetResponse ();
' Create a request for the URL.
Dim request As WebRequest = WebRequest.Create("http://www.contoso.com/default.html")
' If required by the server, set the credentials.
request.Credentials = CredentialCache.DefaultCredentials
' Get the response.
Dim response As HttpWebResponse = CType(request.GetResponse(), HttpWebResponse)
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 die Internetressource erforderlich sind.
Anmerkung
Die WebRequest Klasse ist eine abstract Klasse. Das tatsächliche Verhalten von WebRequest Instanzen zur Laufzeit wird durch die von der WebRequest.Create-Methode zurückgegebene absteigende Klasse bestimmt. Weitere Informationen zu Standardwerten und Ausnahmen finden Sie in der Dokumentation für die untergeordneten Klassen, z. B. HttpWebRequest und FileWebRequest.
