FederationConfiguration 构造函数

定义

命名空间:

System.IdentityModel.Services.Configuration

程序集:

System.IdentityModel.Services.dll

初始化 FederationConfiguration 类的新实例。

重载

FederationConfiguration()	通过加载设置初始化 FederationConfiguration 选件类的新实例从配置文件的 system.identityModel.services 部分。
FederationConfiguration(Boolean)	通过有选择地加载来自配置文件的 system.identityModel.services 部分的设置来初始化 FederationConfiguration 类的新的实例。
FederationConfiguration(String)	从指定的名称 <federationConfiguration> 元素初始化 FederationConfiguration 类的新实例。

注解

重要

在配置的任何 HTTP 模块使用新 FederationConfiguration 实例之前，请调用 Initialize 方法以确保正确初始化实例。

FederationConfiguration()

通过加载设置初始化 FederationConfiguration 选件类的新实例从配置文件的 system.identityModel.services 部分。

public:
 FederationConfiguration();

public FederationConfiguration ();

Public Sub New ()

注解

通过从配置部分加载设置来初始化新实例中的 <system.identityModel.services> 属性。 此构造函数使用 loadConfig 参数 true调用FederationConfiguration.FederationConfiguration(Boolean)构造函数。

警告

在配置的任何 HTTP 模块使用新 FederationConfiguration 实例之前，请调用 Initialize 方法以确保正确初始化实例。

另请参阅

• FederationConfiguration(Boolean)

FederationConfiguration(Boolean)

通过有选择地加载来自配置文件的 system.identityModel.services 部分的设置来初始化 FederationConfiguration 类的新的实例。

public:
 FederationConfiguration(bool loadConfig);

public FederationConfiguration (bool loadConfig);

new System.IdentityModel.Services.Configuration.FederationConfiguration : bool -> System.IdentityModel.Services.Configuration.FederationConfiguration

Public Sub New (loadConfig As Boolean)

参数

loadConfig

Boolean

初始化的true 与配置文件加载的设置；初始化的 false 设置为默认值。

例外

InvalidOperationException

此 system.identityModel 配置节未在配置文件中定义。

注解

警告

在配置的任何 HTTP 模块使用新 FederationConfiguration 实例之前，请调用 Initialize 方法以确保正确初始化实例。

system.identityModel必须在配置文件中的 <section> 元素下的 <configSections> 元素中指定 节，否则会引发异常。

<configSections>  
  <section name="system.identityModel" type="System.IdentityModel.Configuration.SystemIdentityModelSection, System.IdentityModel, Version=4.0.0.0, Culture=neutral, PublicKeyToken=B77A5C561934E089" />  
</configSections>  

如果 loadConfig 为 true 并且只指定了单个 <federationConfiguration> 元素，则使用该元素加载设置。 如果指定了多个 <federationConfiguration> 元素，则 方法会尝试从具有 的未命名的 DefaultFederationConfigurationName元素加载设置。 如果此类元素不存在，该方法将返回而不加载设置。 调用 方法时， Initialize 这会导致异常。

警告

Microsoft 建议，如果在配置节中system.identityModel.services指定多个<federationConfiguration>元素，则至少有一个元素未命名或名称设置为空字符串。

FederationConfiguration(String)

从指定的名称 <federationConfiguration> 元素初始化 FederationConfiguration 类的新实例。

public:
 FederationConfiguration(System::String ^ federationConfigurationName);

public FederationConfiguration (string federationConfigurationName);

new System.IdentityModel.Services.Configuration.FederationConfiguration : string -> System.IdentityModel.Services.Configuration.FederationConfiguration

Public Sub New (federationConfigurationName As String)

参数

federationConfigurationName

String

从中加载配置的 <federationConfiguration> 元素的名称。

例外

InvalidOperationException

在配置文件中没有 system.identityModel.services 节定义。

- 或 -

在配置文件中没有 system.identityModel 节定义。

- 或 -

该名称与 <federationConfiguration> 类中的 system.identityModel.services 没有指定元素名称。

注解

警告

在配置的任何 HTTP 模块使用新 FederationConfiguration 实例之前，请调用 Initialize 方法以确保正确初始化实例。

如果调用此构造函数，则 <system.identityModel.services> 配置文件中必须存在具有 <federationConfiguration> 指定名称的元素的配置节。

system.identityModel节 和 system.identityModel.services 都必须在<section>配置文件中的 元素下的<configSections>元素中指定，否则会引发异常。

<configSections>  
  <section name="system.identityModel" type="System.IdentityModel.Configuration.SystemIdentityModelSection, System.IdentityModel, Version=4.0.0.0, Culture=neutral, PublicKeyToken=B77A5C561934E089" />  
  <section name="system.identityModel.services" type="System.IdentityModel.Services.Configuration.SystemIdentityModelServicesSection, System.IdentityModel.Services, Version=4.0.0.0, Culture=neutral, PublicKeyToken=B77A5C561934E089" />  
</configSections>