WebRequest.PreAuthenticate Propriété

Définition

Espace de noms:

System.Net

Assembly:

System.Net.Requests.dll

Source:

WebRequest.cs

En cas de substitution dans une classe descendante, indique si la demande doit être préalablement authentifiée.

public:
 virtual property bool PreAuthenticate { bool get(); void set(bool value); };

public virtual bool PreAuthenticate { get; set; }

member this.PreAuthenticate : bool with get, set

Public Overridable Property PreAuthenticate As Boolean

Valeur de propriété

Boolean

true pour effectuer l'authentification préalable ; sinon, false.

Exceptions

NotImplementedException

Toutes les tentatives possibles sont effectuées pour obtenir ou définir la propriété si celle-ci n’est pas substituée dans une classe descendante.

Exemples

L’exemple suivant définit la PreAuthenticate propriété sur true afin que le NetworkCredential stocké dans la Credentials propriété soit envoyé avec la demande de ressource.

// Create a new webrequest to the mentioned URL.
WebRequest^ myWebRequest = WebRequest::Create( url );

// Set 'Preauthenticate' property to true. Credentials will be sent with the request.
myWebRequest->PreAuthenticate = true;

Console::WriteLine( "\nPlease enter your credentials for the requested Url" );
Console::WriteLine( "UserName" );
String^ UserName = Console::ReadLine();
Console::WriteLine( "Password" );
String^ Password = Console::ReadLine();

// Create a New 'NetworkCredential' object.
NetworkCredential^ networkCredential = gcnew NetworkCredential( UserName,Password );

// Associate the 'NetworkCredential' object with the 'WebRequest' object.
myWebRequest->Credentials = networkCredential;

// Assign the response object of 'WebRequest' to a 'WebResponse' variable.
WebResponse^ myWebResponse = myWebRequest->GetResponse();

// Create a new webrequest to the mentioned URL.
WebRequest myWebRequest=WebRequest.Create(url);

// Set 'Preauthenticate'  property to true.  Credentials will be sent with the request.
myWebRequest.PreAuthenticate=true;

Console.WriteLine("\nPlease enter your credentials for the requested Url");
Console.WriteLine("UserName");
string UserName=Console.ReadLine();
Console.WriteLine("Password");
string Password=Console.ReadLine();

// Create a New 'NetworkCredential' object.
NetworkCredential networkCredential=new NetworkCredential(UserName,Password);

// Associate the 'NetworkCredential' object with the 'WebRequest' object.
myWebRequest.Credentials=networkCredential;

// Assign the response object of 'WebRequest' to a 'WebResponse' variable.
WebResponse myWebResponse=myWebRequest.GetResponse();

' Create a new webrequest to the mentioned URL.
Dim myWebRequest As WebRequest = WebRequest.Create(url)

' Set 'Preauthenticate'  property to true.
myWebRequest.PreAuthenticate = True
Console.WriteLine(ControlChars.Cr + "Please enter your credentials for the requested Url")
Console.WriteLine("UserName")
Dim UserName As String = Console.ReadLine()
Console.WriteLine("Password")
Dim Password As String = Console.ReadLine()

' Create a New 'NetworkCredential' object.
Dim networkCredential As New NetworkCredential(UserName, Password)

' Associate the 'NetworkCredential' object with the 'WebRequest' object.
myWebRequest.Credentials = networkCredential

' Assign the response object of 'WebRequest' to a 'WebResponse' variable.
Dim myWebResponse As WebResponse = myWebRequest.GetResponse()

Remarques

À l’exception de la première requête, la PreAuthenticate propriété indique s’il faut envoyer des informations d’authentification avec les demandes suivantes sans attendre que le serveur les conteste. Quand PreAuthenticate a falsela valeur , attend WebRequest une demande d’authentification avant d’envoyer des informations d’authentification.

Notes

La WebRequest classe est une abstract classe . Le comportement réel des instances au moment de WebRequest l’exécution est déterminé par la classe descendante retournée par la WebRequest.Create méthode . Pour plus d’informations sur les valeurs et exceptions par défaut, consultez la documentation relative aux classes descendantes, telles que HttpWebRequest et FileWebRequest.

Voir aussi

• PreAuthenticate