AuthenticationManager.Unregister Methode

  • Referenz

Definition

Namespace:
System.Net
Assembly:
System.Net.Requests.dll
Assembly:
System.dll
Assembly:
netstandard.dll

Entfernt die Authentifizierungsmodule aus der Liste der registrierten Module.

Überlädt

Unregister(IAuthenticationModule)

Entfernt das angegebene Authentifizierungsmodul aus der Liste der registrierten Module.
Unregister(String)

Entfernt die Authentifizierungsmodule mit dem angegebenen Authentifizierungsschema aus der Liste der registrierten Module.

Unregister(IAuthenticationModule)

Entfernt das angegebene Authentifizierungsmodul aus der Liste der registrierten Module.

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

Parameter

authenticationModule
IAuthenticationModule

Das IAuthenticationModule, das aus der Liste der registrierten Module entfernt werden soll.

Ausnahmen

ArgumentNullException

authenticationModule ist null.

InvalidOperationException

Das angegebene IAuthenticationModule ist nicht registriert.

Beispiele

Im folgenden Beispiel wird die Unregister Methode verwendet, um das angegebene Authentifizierungsmodul aus der Liste der registrierten Module zu entfernen. Ein vollständiges Beispiel finden Sie in der AuthenticationManager Klasse.

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

Hinweise

Die Unregister Methode entfernt das angegebene Authentifizierungsmodul aus der Liste der Authentifizierungsmodule, die von der Authenticate Methode aufgerufen werden. Das Modul muss der Liste mithilfe der Register Methode hinzugefügt worden sein, bevor es aus der Liste entfernt werden kann.

Gilt für

Unregister(String)

Entfernt die Authentifizierungsmodule mit dem angegebenen Authentifizierungsschema aus der Liste der registrierten Module.

public:
 static void Unregister(System::String ^ authenticationScheme);
public static void Unregister (string authenticationScheme);
static member Unregister : string -> unit
Public Shared Sub Unregister (authenticationScheme As String)

Parameter

authenticationScheme
String

Das Authentifizierungsschema des zu entfernenden Moduls.

Ausnahmen

ArgumentNullException

authenticationScheme ist null.

InvalidOperationException

Ein Modul ist für dieses Authentifizierungsschema nicht registriert.

Beispiele

Im folgenden Beispiel wird die Unregister Methode verwendet, um ein Authentifizierungsmodul mit dem angegebenen Authentifizierungsschema aus der Liste der registrierten Module zu entfernen.

IEnumerator^ registeredModules = AuthenticationManager::RegisteredModules;
// Display all the modules that are already registered with the system.
DisplayAllModules();
registeredModules->Reset();
registeredModules->MoveNext();
// Get the first Authentication module registered with the system.
IAuthenticationModule^ authenticationModule1 = dynamic_cast<IAuthenticationModule^>(registeredModules->Current);
// Call the UnRegister() method to unregister the first authentication module from the system.
String^ authenticationScheme = authenticationModule1->AuthenticationType;
AuthenticationManager::Unregister( authenticationScheme );
Console::WriteLine(  "\nSuccessfully unregistered '{0}'.", authenticationModule1 );
// Display all modules to see that the module was unregistered.
DisplayAllModules();

IEnumerator registeredModules = AuthenticationManager.RegisteredModules;
// Display all the modules that are already registered with the system.
DisplayAllModules();
registeredModules.Reset();
registeredModules.MoveNext();
// Get the first Authentication module registered with the system.
IAuthenticationModule authenticationModule1 = (IAuthenticationModule)registeredModules.Current;
// Call the UnRegister() method to unregister the first authentication module from the system.
String authenticationScheme = authenticationModule1.AuthenticationType;
AuthenticationManager.Unregister(authenticationScheme);
Console.WriteLine("\nSuccessfully unregistered '{0}",authenticationModule1+"'.");
// Display all modules to see that the module was unregistered.
DisplayAllModules();

Dim registeredModules As IEnumerator = AuthenticationManager.RegisteredModules
DisplayAllModules()

registeredModules.Reset()
registeredModules.MoveNext()

'Get the first Authentication module registered with the system
Dim authenticationModule1 As IAuthenticationModule = CType(registeredModules.Current, IAuthenticationModule)

'Call the UnRegister method to unregister the first authentication module from the system.
Dim authenticationScheme As [String] = authenticationModule1.AuthenticationType
AuthenticationManager.Unregister(authenticationScheme)
Console.WriteLine(ControlChars.Cr + "Successfully unregistered {0}", authenticationModule1)
'Display all modules to see that the module was unregistered.
DisplayAllModules()
'Call the Register method to register authenticationModule1 module again.
AuthenticationManager.Register(authenticationModule1)
Console.WriteLine(ControlChars.Cr + "Successfully re-registered {0}", authenticationModule1)
'Display the modules to verify that 'authenticationModule1' has been registered again.
DisplayAllModules()

Hinweise

Die Unregister Methode entfernt das Authentifizierungsmodul mit dem angegebenen Authentifizierungsschema aus der Liste der Authentifizierungsmodule, die von der Authenticate Methode aufgerufen werden. Das Modul muss der Liste mithilfe der Register Methode hinzugefügt worden sein, bevor es aus der Liste entfernt werden kann.

Gilt für