HttpWebRequest.Credentials Vlastnost
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Získá nebo nastaví ověřovací informace pro požadavek.
public:
virtual property System::Net::ICredentials ^ Credentials { System::Net::ICredentials ^ get(); void set(System::Net::ICredentials ^ value); };
public override System.Net.ICredentials Credentials { get; set; }
public override System.Net.ICredentials? Credentials { get; set; }
member this.Credentials : System.Net.ICredentials with get, set
Public Overrides Property Credentials As ICredentials
Hodnota vlastnosti
ICredentials, která obsahuje přihlašovací údaje pro ověření přidružené k požadavku. Výchozí hodnota je null
.
Příklady
Následující příklad kódu nastaví přihlašovací údaje pro požadavek.
#using <System.dll>
using namespace System;
using namespace System::Net;
using namespace System::Text;
using namespace System::IO;
// Specify the URL to receive the request.
int main()
{
array<String^>^args = Environment::GetCommandLineArgs();
HttpWebRequest^ request = dynamic_cast<HttpWebRequest^>(WebRequest::Create(args[1]));
// Set some reasonable limits on resources used by this request
request->MaximumAutomaticRedirections = 4;
request->MaximumResponseHeadersLength = 4;
// Set credentials to use for this request.
request->Credentials = CredentialCache::DefaultCredentials;
HttpWebResponse^ response = dynamic_cast<HttpWebResponse^>(request->GetResponse());
Console::WriteLine("Content length is {0}", response->ContentLength);
Console::WriteLine("Content type is {0}", response->ContentType);
// Get the stream associated with the response.
Stream^ receiveStream = response->GetResponseStream();
// Pipes the stream to a higher level stream reader with the required encoding format.
StreamReader^ readStream = gcnew StreamReader(receiveStream, Encoding::UTF8);
Console::WriteLine("Response stream received.");
Console::WriteLine(readStream->ReadToEnd());
response->Close();
readStream->Close();
}
/*
The output from this example will vary depending on the value passed into Main
but will be similar to the following:
Content length is 1542
Content type is text/html; charset=utf-8
Response stream received.
<html>
...
</html>
*/
using System;
using System.Net;
using System.Text;
using System.IO;
public class Test
{
// Specify the URL to receive the request.
public static void Main (string[] args)
{
HttpWebRequest request = (HttpWebRequest)WebRequest.Create(args[0]);
// Set some reasonable limits on resources used by this request
request.MaximumAutomaticRedirections = 4;
request.MaximumResponseHeadersLength = 4;
// Set credentials to use for this request.
request.Credentials = CredentialCache.DefaultCredentials;
HttpWebResponse response = (HttpWebResponse)request.GetResponse();
Console.WriteLine("Content length is {0}", response.ContentLength);
Console.WriteLine("Content type is {0}", response.ContentType);
// Get the stream associated with the response.
Stream receiveStream = response.GetResponseStream();
// Pipes the stream to a higher level stream reader with the required encoding format.
StreamReader readStream = new StreamReader(receiveStream, Encoding.UTF8);
Console.WriteLine("Response stream received.");
Console.WriteLine(readStream.ReadToEnd());
response.Close();
readStream.Close();
}
}
/*
The output from this example will vary depending on the value passed into Main
but will be similar to the following:
Content length is 1542
Content type is text/html; charset=utf-8
Response stream received.
<html>
...
</html>
*/
Imports System.Net
Imports System.Text
Imports System.IO
Public Class Test
' Specify the URL to receive the request.
Public Shared Sub Main(ByVal args() As String)
Dim request As HttpWebRequest = CType(WebRequest.Create(args(0)), HttpWebRequest)
' Set some reasonable limits on resources used by this request
request.MaximumAutomaticRedirections = 4
request.MaximumResponseHeadersLength = 4
' Set credentials to use for this request.
request.Credentials = CredentialCache.DefaultCredentials
Dim response As HttpWebResponse = CType(request.GetResponse(), HttpWebResponse)
Console.WriteLine("Content length is {0}", response.ContentLength)
Console.WriteLine("Content type is {0}", response.ContentType)
' Get the stream associated with the response.
Dim receiveStream As Stream = response.GetResponseStream()
' Pipes the stream to a higher level stream reader with the required encoding format.
Dim readStream As New StreamReader(receiveStream, Encoding.UTF8)
Console.WriteLine("Response stream received.")
Console.WriteLine(readStream.ReadToEnd())
response.Close()
readStream.Close()
End Sub
End Class
'
'The output from this example will vary depending on the value passed into Main
'but will be similar to the following:
'
'Content length is 1542
'Content type is text/html; charset=utf-8
'Response stream received.
'...
'
'
Poznámky
Opatrnost
WebRequest
, HttpWebRequest
, ServicePoint
a WebClient
jsou zastaralé a neměli byste je používat pro nový vývoj. Místo toho použijte HttpClient.
Vlastnost Credentials obsahuje ověřovací informace pro identifikaci tvůrce požadavku. Vlastnost Credentials může být buď NetworkCredential, v takovém případě se informace o uživateli, heslu a doméně obsažené v objektu NetworkCredential používají k ověření požadavku, nebo to může být CredentialCache, v takovém případě se identifikátor URI požadavku používá k určení uživatele, hesla a informací o doméně, které se mají použít k ověření požadavku.
Ve většině klientských scénářů byste měli použít vlastnost DefaultCredentials, která obsahuje přihlašovací údaje aktuálně přihlášeného uživatele. Chcete-li to provést, nastavte vlastnost UseDefaultCredentials na true
namísto nastavení této vlastnosti.
Pokud se HttpWebRequest třída používá v aplikaci střední vrstvy, jako je například aplikace ASP.NET, přihlašovací údaje ve vlastnosti DefaultCredentials patří k účtu, na kterém běží stránka ASP (přihlašovací údaje na straně serveru). Obvykle byste tuto vlastnost nastavili na přihlašovací údaje klienta, jehož jménem je požadavek proveden.
Poznámka
Schéma ověřování NTLM nelze použít k zosobnění jiného uživatele. Protokol Kerberos musí být speciálně nakonfigurovaný tak, aby podporoval zosobnění.
Pokud chcete httpWebRequest omezit na jednu nebo více metod ověřování, použijte třídu CredentialCache a svázejte své přihlašovací údaje s jedním nebo více schématy ověřování.
Podporovaná schémata ověřování zahrnují digest, Negotiate, Kerberos, NTLM a Basic.
Z bezpečnostních důvodů při automatickém sledování přesměrování uložte přihlašovací údaje, které chcete zahrnout do přesměrování, do CredentialCache a přiřaďte je k této vlastnosti. Tato vlastnost se automaticky nastaví na null
při přesměrování, pokud obsahuje cokoli kromě CredentialCache. Když se tato hodnota vlastnosti automaticky nastaví na null
za těchto podmínek, zabrání tomu, aby se přihlašovací údaje odesílaly do jakéhokoli nezamýšleného cíle.
Platí pro
Váš názor
https://aka.ms/ContentUserFeedback.
Připravujeme: V průběhu roku 2024 budeme postupně vyřazovat problémy z GitHub coby mechanismus zpětné vazby pro obsah a nahrazovat ho novým systémem zpětné vazby. Další informace naleznete v tématu:Odeslat a zobrazit názory pro