WebClient.Credentials Eigenschap
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee haalt u de netwerkreferenties op die naar de host worden verzonden en worden gebruikt om de aanvraag te verifiëren.
public:
property System::Net::ICredentials ^ Credentials { System::Net::ICredentials ^ get(); void set(System::Net::ICredentials ^ value); };public System.Net.ICredentials Credentials { get; set; }member this.Credentials : System.Net.ICredentials with get, setPublic Property Credentials As ICredentialsWaarde van eigenschap
Een ICredentials met de verificatiereferenties voor de aanvraag. De standaardwaarde is null.
Voorbeelden
In het volgende codevoorbeeld worden de systeemreferenties van de gebruiker gebruikt om een aanvraag te verifiëren.
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
Opmerkingen
Caution
WebRequest, HttpWebRequest, ServicePointen WebClient zijn verouderd en u moet ze niet gebruiken voor nieuwe ontwikkeling. Gebruik in plaats daarvan HttpClient.
De Credentials eigenschap bevat de verificatiereferenties die worden gebruikt voor toegang tot een resource op een host. In de meeste scenario's aan de clientzijde moet u de DefaultCredentialsreferenties van de momenteel aangemelde gebruiker gebruiken. Hiervoor stelt u de UseDefaultCredentials eigenschap true in op in plaats van deze eigenschap in te stellen.
Als de klasse WebClient wordt gebruikt in een middelste laagtoepassing, zoals een ASP.NET toepassing, behoort de DefaultCredentials tot het account waarop de ASP-pagina wordt uitgevoerd (de referenties aan de serverzijde). Normaal gesproken stelt u deze eigenschap in op de referenties van de client namens wie de aanvraag wordt ingediend.
Als u om veiligheidsredenen automatisch omleidingen volgt, slaat u de referenties op die u wilt opnemen in de omleiding in een CredentialCache en wijst u deze toe aan deze eigenschap. Deze eigenschap wordt automatisch ingesteld null bij omleiding als deze iets bevat behalve een CredentialCache. Als deze eigenschapswaarde automatisch wordt ingesteld null op onder deze voorwaarden, voorkomt u dat referenties naar een onbedoelde bestemming worden verzonden.