WebRequest.PreAuthenticate Propriedade

Definição

Namespace:

System.Net

Assembly:

System.Net.Requests.dll

Origem:

WebRequest.cs

Quando substituído em uma classe descendente, indica se a solicitação deve ser pré-autenticada.

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

Valor da propriedade

Boolean

true para pré-autenticar; caso contrário, false.

Exceções

NotImplementedException

Qualquer tentativa é feita para obter ou definir a propriedade, quando a propriedade não é substituída em uma classe descendente.

Exemplos

O exemplo a seguir define a propriedade PreAuthenticate como true para que o NetworkCredential armazenado na propriedade Credentials seja enviado junto com a solicitação de recurso.

// 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()

Comentários

Cuidado

WebRequest, HttpWebRequest, ServicePointe WebClient estão obsoletos e você não deve usá-los para um novo desenvolvimento. Em vez disso, use HttpClient.

Com exceção da primeira solicitação, a propriedade PreAuthenticate indica se enviar informações de autenticação com solicitações subsequentes sem esperar para ser contestada pelo servidor. Quando PreAuthenticate é false, o WebRequest aguarda um desafio de autenticação antes de enviar informações de autenticação.

Nota

A classe WebRequest é uma classe abstract. O comportamento real de WebRequest instâncias em tempo de execução é determinado pela classe descendente retornada pelo método WebRequest.Create. Para obter mais informações sobre valores e exceções padrão, consulte a documentação das classes descendentes, como HttpWebRequest e FileWebRequest.

Confira também

• PreAuthenticate