WebRequest.PreAuthenticate Property

Definition

При переопределении во вложенном классе показывает, необходима ли предварительная проверка подлинности данного запроса.When overridden in a descendant class, indicates whether to pre-authenticate the request.

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

Property Value

Boolean

Значение true — выполнять предварительную проверку подлинности; в противном случае — false.true to pre-authenticate; otherwise, false.

Exceptions

Если свойство не переопределено во вложенном классе, предпринимаются все возможные попытки вернуть или задать его.Any attempt is made to get or set the property, when the property is not overridden in a descendant class.

Examples

В следующем примере свойству PreAuthenticate присваивается значение true, чтобы NetworkCredential, хранимые в свойстве Credentials, отправлялись вместе с запросом ресурса.The following example sets the PreAuthenticate property to true so that the NetworkCredential stored in the Credentials property will be sent to along with the resource request.

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

Remarks

За исключением первого запроса, свойство PreAuthenticate указывает, следует ли отсылать сведения о проверке подлинности с последующими запросами, не дожидаясь обращения к серверу.With the exception of the first request, the PreAuthenticate property indicates whether to send authentication information with subsequent requests without waiting to be challenged by the server. Если PreAuthenticate false, WebRequest ожидает запроса проверки подлинности перед отправкой сведений для проверки подлинности.When PreAuthenticate is false, the WebRequest waits for an authentication challenge before sending authentication information.

Note

Класс WebRequest является abstractным классом.The WebRequest class is an abstract class. Фактическое поведение WebRequest экземпляров во время выполнения определяется классом-наследником, возвращенным методом WebRequest.Create.The actual behavior of WebRequest instances at run time is determined by the descendant class returned by the WebRequest.Create method. Дополнительные сведения о значениях по умолчанию и исключениях см. в документации по классам-наследникам, таким как HttpWebRequest и FileWebRequest.For more information about default values and exceptions, see the documentation for the descendant classes, such as HttpWebRequest and FileWebRequest.

Applies to

See also