AuthenticationManager.PreAuthenticate-Methode

Führt die Vorauthentifizierung einer Anforderung durch.

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

Syntax

'Declaration
Public Shared Function PreAuthenticate ( _
    request As WebRequest, _
    credentials As ICredentials _
) As Authorization
'Usage
Dim request As WebRequest
Dim credentials As ICredentials
Dim returnValue As Authorization

returnValue = AuthenticationManager.PreAuthenticate(request, credentials)

public static Authorization PreAuthenticate (
    WebRequest request,
    ICredentials credentials
)

public:
static Authorization^ PreAuthenticate (
    WebRequest^ request, 
    ICredentials^ credentials
)

public static Authorization PreAuthenticate (
    WebRequest request, 
    ICredentials credentials
)

public static function PreAuthenticate (
    request : WebRequest, 
    credentials : ICredentials
) : Authorization

Parameter

• request
  Eine WebRequest an eine Internetressource.

• credentials
  Die mit dieser Anforderung verknüpften ICredentials.

Rückgabewert

Eine Instanz der Authorization-Klasse, wenn die Anforderung vorauthentifiziert werden kann, andernfalls NULL (Nothing in Visual Basic). Wenn credentials auf NULL (Nothing in Visual Basic) festgelegt ist, gibt diese Methode NULL (Nothing in Visual Basic) zurück.

Ausnahmen

Hinweise

Wenn das Authentifizierungsmodul die Anforderung vorauthentifizieren kann, gibt die PreAuthenticate-Methode eine Authentication-Instanz zurück und sendet die Autorisierungsinformationen präventiv an den Server, ohne auf die Aufforderung durch die Ressource zu warten. Dieses Verhalten wird in Abschnitt 3.3 von RFC 2617 (HTTP Authentication: Basic and Digest Access Authentication) dargestellt. Durch Authentifizierungsmodule, die die Vorauthentifizierung unterstützen, können Clients die Leistung des Servers steigern, da zusätzliche Schleifen aufgrund von Authentifizierungsabfragen vermieden werden.

Bei Authentifizierungsmodulen, die Anforderungen vorauthentifizieren können, ist die IAuthenticationModule.CanPreAuthenticate-Eigenschaft auf true festgelegt.

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

AuthenticationManager-Klasse
AuthenticationManager-Member
System.Net-Namespace