AuthenticationManager.Register(IAuthenticationModule) Metodo

Definizione

Registra un modulo di autenticazione con il gestore di autenticazione.Registers an authentication module with the authentication manager.

public:
 static void Register(System::Net::IAuthenticationModule ^ authenticationModule);
public static void Register (System.Net.IAuthenticationModule authenticationModule);
static member Register : System.Net.IAuthenticationModule -> unit
Public Shared Sub Register (authenticationModule As IAuthenticationModule)

Parametri

authenticationModule
IAuthenticationModule

Il IAuthenticationModule da registrare con il gestore di autenticazione.The IAuthenticationModule to register with the authentication manager.

Eccezioni

authenticationModule è null.authenticationModule is null.

Esempi

Nell'esempio seguente viene registrato un modulo di autenticazione con il gestore di autenticazione.The following example registers an authentication module with the authentication manager. Per un esempio completo, vedere la AuthenticationManager classe.For a complete example, refer to the AuthenticationManager class.

// This is the program entry point. It allows the user to enter 
// her credentials and the Internet resource (Web page) to access.
// It also unregisters the standard and registers the customized basic 
// authentication.
static void Main()
{
   array<String^>^args = Environment::GetCommandLineArgs();
   if ( args->Length < 4 )
         showusage();
   else
   {
      
      // Read the user's credentials.
      uri = args[ 1 ];
      username = args[ 2 ];
      password = args[ 3 ];
      if ( args->Length == 4 )
               domain = String::Empty; // If the domain exists, store it. Usually the domain name
      else
               domain = args[ 4 ];

      
      // is by default the name of the server hosting the Internet
      // resource.
      // Unregister the standard Basic authentication module.
      AuthenticationManager::Unregister( "Basic" );
      
      // Instantiate the custom Basic authentication module.
      CustomBasic^ customBasicModule = gcnew CustomBasic;
      
      // Register the custom Basic authentication module.
      AuthenticationManager::Register( customBasicModule );
      
      // Display registered Authorization modules.
      displayRegisteredModules();
      
      // Read the specified page and display it on the console.
      getPage( uri );
   }

   return;
}

   // This is the program entry point. It allows the user to enter 
   // her credentials and the Internet resource (Web page) to access.
   // It also unregisters the standard and registers the customized basic 
   // authentication.
   public static void Main(string[] args) 
   {
   
     if (args.Length < 3)
       showusage();
     else 
     {    
        
       // Read the user's credentials.
       uri = args[0];
       username = args[1];
       password = args[2];

       if (args.Length == 3)
         domain = string.Empty;
       else
         // If the domain exists, store it. Usually the domain name
         // is by default the name of the server hosting the Internet
         // resource.
         domain = args[3];

       // Unregister the standard Basic authentication module.
       AuthenticationManager.Unregister("Basic");

       // Instantiate the custom Basic authentication module.
       CustomBasic customBasicModule = new CustomBasic();
          
       // Register the custom Basic authentication module.
       AuthenticationManager.Register(customBasicModule);

       // Display registered Authorization modules.
       displayRegisteredModules();
       
       // Read the specified page and display it on the console.
       getPage(uri);
     }
     return;
   }
   ' This is the program entry point. It allows the user to enter 
   ' her credentials and the Internet resource (Web page) to access.
   ' It also unregisters the standard and registers the customized basic 
   ' authentication.
  Private Overloads Shared Sub Main(ByVal args() As String)

    If args.Length < 4 Then
      showusage()
    Else

      ' Read the user's credentials.
      uri = args(1)
      username = args(2)
      password = args(3)

      If args.Length = 4 Then
        domain = String.Empty
        ' If the domain exists, store it. Usually the domain name
        ' is by default the name of the server hosting the Internet
        ' resource.
      Else
        domain = args(5)
      End If
      ' Unregister the standard Basic authentication module.
      AuthenticationManager.Unregister("Basic")

      ' Instantiate the custom Basic authentication module.
      Dim customBasicModule As New CustomBasic()

      ' Register the custom Basic authentication module.
      AuthenticationManager.Register(customBasicModule)

      ' Display registered Authorization modules.
      displayRegisteredModules()

      ' Read the specified page and display it on the console.
      getPage(uri)
    End If
    Return
  End Sub
End Class

Commenti

Il Register metodo aggiunge i moduli di autenticazione alla fine dell'elenco dei moduli chiamati Authenticate dal metodo.The Register method adds authentication modules to the end of the list of modules called by the Authenticate method. I moduli di autenticazione vengono chiamati nell'ordine in cui sono stati aggiunti all'elenco.Authentication modules are called in the order in which they were added to the list. Se un modulo con lo stesso AuthenticationType è già registrato, questo metodo rimuove il modulo registrato e aggiunge authenticationModule alla fine dell'elenco.If a module with the same AuthenticationType is already registered, this method removes the registered module and adds authenticationModule to the end of the list.

Sicurezza

SecurityPermission
per l'esecuzione di codice non gestito.for executing unmanaged code. Enumerazione associata: SecurityPermissionFlag.Associated enumeration: SecurityPermissionFlag.

Si applica a