AuthenticationManager.Unregister 方法

定义

命名空间:

System.Net

程序集:

System.Net.Requests.dll

程序集:

System.dll

程序集:

netstandard.dll

将身份验证模块从已注册的模块列表中移除。

重载

Unregister(IAuthenticationModule)	将指定的身份验证模块从已注册的模块列表中移除。
Unregister(String)	将具有指定身份验证方案的身份验证模块从已注册模块列表中移除。

Unregister(IAuthenticationModule)

将指定的身份验证模块从已注册的模块列表中移除。

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)

参数

authenticationModule

IAuthenticationModule

要从已注册模块列表中移除的 IAuthenticationModule。

例外

ArgumentNullException

authenticationModule 为 null。

InvalidOperationException

指定的 IAuthenticationModule 没有注册。

示例

以下示例使用 Unregister 该方法从已注册模块列表中删除指定的身份验证模块。 有关完整示例，请参阅 AuthenticationManager 类。

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

注解

该方法 Unregister 从该方法调用 Authenticate 的身份验证模块列表中删除指定的身份验证模块。 必须先使用 Register 该方法将模块添加到列表中，然后才能从列表中删除该模块。

Unregister(String)

将具有指定身份验证方案的身份验证模块从已注册模块列表中移除。

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)

参数

authenticationScheme

String

要移除的模块的身份验证方案。

例外

ArgumentNullException

authenticationScheme 为 null。

InvalidOperationException

此身份验证方案的模块没有注册。

示例

以下示例使用 Unregister 该方法从已注册模块列表中删除具有指定身份验证方案的身份验证模块。

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()

注解

该方法 Unregister 从该方法调用 Authenticate 的身份验证模块列表中删除具有指定身份验证方案的身份验证模块。 必须先使用 Register 该方法将模块添加到列表中，然后才能从列表中删除该模块。