IAuthenticationModule.PreAuthenticate Method (WebRequest, ICredentials)


Returns an instance of the Authorization class for an authentication request to a server.

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

Authorization PreAuthenticate(
	WebRequest request,
	ICredentials credentials


Type: System.Net.WebRequest

The WebRequest instance associated with the authentication request.

Type: System.Net.ICredentials

The credentials associated with the authentication request.

Return Value

Type: System.Net.Authorization

An Authorization instance containing the authorization message for the request.

When the CanPreAuthenticate property is true, the PreAuthenticate method will return an instance of the Authorization class containing an authentication message.

The following example shows how to use the PreAuthenticate method. For a complete example refer to the AuthenticationManager class.

// The PreAuthenticate method specifies whether the authentication implemented 
// by this class allows pre-authentication. 
// Even if you do not use it, this method must be implemented to obey to the rules 
// of interface implementation.
// In this case it always returns null. 
public Authorization PreAuthenticate(WebRequest request, ICredentials credentials) 
  return null;

.NET Framework
Available since 1.1
Return to top