WebRequest.Credentials Tulajdonság
Definíció
Fontos
Egyes információk olyan, kiadás előtti termékekre vonatkoznak, amelyek a kiadásig még jelentősen módosulhatnak. A Microsoft nem vállal kifejezett vagy törvényi garanciát az itt megjelenő információért.
Ha egy leszármazott osztályban felül van bírálva, lekéri vagy beállítja a kérés internetes erőforrással való hitelesítéséhez használt hálózati hitelesítő adatokat.
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 ICredentialsTulajdonság értéke
A ICredentials kéréshez társított hitelesítési hitelesítő adatokat tartalmazó. Az alapértelmezett érték a null.
Kivételek
A tulajdonság lekérésére vagy beállítására tett minden kísérlet, ha a tulajdonság nem felül van bírálva egy leszármazott osztályban.
Példák
Az alábbi példa az Credentials aktuális felhasználó alapértelmezett hitelesítő adataival állítja be a tulajdonságot. A kérés teljesítésekor a rendszer az ebben a tulajdonságban tárolt hitelesítő adatokat használja az ügyfél ellenőrzéséhez. Ez megegyezik a tulajdonság UseDefaultCredentialsbeállításávaltrue.
// 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)
Megjegyzések
Figyelmeztetés
WebRequest, HttpWebRequest, ServicePointés WebClient elavultak, és nem szabad új fejlesztésre használni őket. A HttpClient használható helyette.
A Credentials tulajdonság tartalmazza az internetes erőforrás eléréséhez szükséges hitelesítési hitelesítő adatokat.
Note
Az WebRequest osztály egy abstract osztály. A példányok futási időben való tényleges viselkedését WebRequest a metódus által WebRequest.Create visszaadott leszármazott osztály határozza meg. Az alapértelmezett értékekkel és kivételekkel kapcsolatos további információkért tekintse meg a leszármazott osztályok dokumentációját, például HttpWebRequest és FileWebRequest.
