WebClient.Credentials Propriété
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Obtient ou définit les informations d'identification réseau envoyées à l'hôte et utilisées pour authentifier la demande.
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
Valeur de propriété
ICredentials contenant les informations d'authentification pour la demande. La valeur par défaut est null
.
Exemples
L’exemple de code suivant utilise les informations d’identification système de l’utilisateur pour authentifier une demande.
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
Remarques
La Credentials propriété contient les informations d’identification d’authentification utilisées pour accéder à une ressource sur un hôte. Dans la plupart des scénarios côté client, vous devez utiliser , DefaultCredentialsqui sont les informations d’identification de l’utilisateur actuellement connecté. Pour ce faire, définissez la propriété true
sur UseDefaultCredentials au lieu de définir cette propriété.
Si la WebClient classe est utilisée dans une application de niveau intermédiaire, telle qu’une application ASP.NET, le DefaultCredentials appartient au compte exécutant la page ASP (les informations d’identification côté serveur). En règle générale, vous définissez cette propriété sur les informations d’identification du client au nom duquel la demande est effectuée.
Pour des raisons de sécurité, lorsque vous suivez automatiquement les redirections, stockez les informations d’identification que vous souhaitez inclure dans la redirection dans un CredentialCache et affectez-les à cette propriété. Cette propriété est automatiquement définie null
sur lors de la redirection si elle contient autre chose qu’un CredentialCache. Le fait que cette valeur de propriété soit automatiquement définie sur null
dans ces conditions empêche l’envoi d’informations d’identification à une destination inattendue.
S’applique à
Voir aussi
Commentaires
https://aka.ms/ContentUserFeedback.
Prochainement : Tout au long de l'année 2024, nous supprimerons progressivement les GitHub Issues en tant que mécanisme de retour d'information pour le contenu et nous les remplacerons par un nouveau système de retour d'information. Pour plus d’informations, voir:Soumettre et afficher des commentaires pour