HttpWebRequest.PreAuthenticate-Eigenschaft

Ruft einen Wert ab, der angibt, ob mit der Anforderung ein Authentifizierungsheader gesendet wird, oder legt diesen fest.

Namespace: System.Net
Assembly: System (in system.dll)

Syntax

'Declaration
Public Overrides Property PreAuthenticate As Boolean
'Usage
Dim instance As HttpWebRequest
Dim value As Boolean

value = instance.PreAuthenticate

instance.PreAuthenticate = value

public override bool PreAuthenticate { get; set; }

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

/** @property */
public boolean get_PreAuthenticate ()

/** @property */
public void set_PreAuthenticate (boolean value)

public override function get PreAuthenticate () : boolean

public override function set PreAuthenticate (value : boolean)

Eigenschaftenwert

true, um nach der Authentifizierung einen WWW-authenticate-HTTP-Header mit Anforderungen zu senden, andernfalls false. Der Standardwert ist false.

Hinweise

Wenn PreAuthenticate auf true festgelegt ist und Anmeldeinformationen angegeben werden, wird nach der erfolgreichen Authentifizierung einer Clientanforderung für einen bestimmten Uri der WWW-authenticate-Header mit jeder Anforderung für diesen Uri gesendet. Andernfalls werden für die Anforderung Standardauthentifizierungsverfahren verwendet.

Mit Ausnahme der ersten Anforderung gibt die PreAuthenticate-Eigenschaft an, ob mit nachfolgenden Anforderungen für die bestimmte Uri Authentifizierungsinformationen gesendet werden sollen, ohne auf eine Aufforderung durch den Server zu warten.

Die folgende Kommunikation zwischen Client und Server veranschaulicht die Auswirkungen dieser Eigenschaft. Bei der Kommunikation wird von der Standardauthentifizierung ausgegangen.

PreAuthenticate ist false.

Client: GET beliebigerUrl

Server: 401 WWW-Authenticate Basic

Client: GET mit Autorisierungsheadern

Server: 200 OK

Client: GET beliebigerUrl

Server: 401 WWW-Authenticate Basic

Client: GET mit Autorisierungsheadern

Server: 200 OK

PreAuthenticate ist true.

Client: GET beliebigerUrl

Server: 401 WWW-Authenticate Basic

Client: GET mit Autorisierungsheadern

Server: 200 OK

Client: GET beliebigerUrl mit Autorisierungsheadern

Wenn das Authentifizierungsschema keine Vorauthentifizierung unterstützt, wird der Wert dieser Eigenschaft ignoriert.

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

HttpWebRequest-Klasse
HttpWebRequest-Member
System.Net-Namespace