WebClient.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í síťové přihlašovací údaje, které se odesílají do hostitele a použijí se k ověření požadavku.
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
Hodnota vlastnosti
Obsahující ICredentials přihlašovací údaje pro ověřování pro požadavek. Výchozí formát je null
.
Příklady
Následující příklad kódu používá k ověření požadavku systémové přihlašovací údaje uživatele.
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
Poznámky
Vlastnost Credentials obsahuje přihlašovací údaje pro ověřování používané pro přístup k prostředku na hostiteli. Ve většině scénářů na straně klienta byste měli použít DefaultCredentials, což jsou přihlašovací údaje aktuálně přihlášeného uživatele. Chcete-li to provést, nastavte UseDefaultCredentials vlastnost na hodnotu true
namísto nastavení této vlastnosti.
WebClient Pokud se třída používá v aplikaci střední vrstvy, jako je ASP.NET aplikace, patří k účtu, DefaultCredentials který spouští stránku ASP (přihlašovací údaje na straně serveru). Obvykle byste tuto vlastnost nastavili na přihlašovací údaje klienta, jehož jménem je žádost podána.
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í, v CredentialCache a přiřaďte je této vlastnosti. Tato vlastnost se při přesměrování automaticky nastaví na null
, pokud obsahuje cokoli kromě CredentialCache. Automatické nastavení této hodnoty vlastnosti na null
za těchto podmínek zabrání odeslání přihlašovacích údajů do jakéhokoli nezamýšleného cíle.
Platí pro
Viz také
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