FederationConfiguration 建構函式

定義

命名空間:

System.IdentityModel.Services.Configuration

組件:

System.IdentityModel.Services.dll

初始化 FederationConfiguration 類別的新執行個體。

多載

FederationConfiguration()	藉由從組態檔的 system.identityModel.services 區段載入設定，初始化 FederationConfiguration 類別的新執行個體。
FederationConfiguration(Boolean)	選擇性地從組態檔的 system.identityModel.services 區段載入設定，初始化 FederationConfiguration 類別的新執行個體。
FederationConfiguration(String)	從指定名稱的 <federationConfiguration> 項目，初始化 FederationConfiguration 類別的新執行個體。

備註

重要

在任何已設定的 HTTP 模組使用新 FederationConfiguration 實例之前，請先呼叫 Initialize 方法，以確保實例已正確初始化。

FederationConfiguration()

藉由從組態檔的 system.identityModel.services 區段載入設定，初始化 FederationConfiguration 類別的新執行個體。

public:
 FederationConfiguration();

public FederationConfiguration ();

Public Sub New ()

備註

從組態區段載入設定 <system.identityModel.services> ，以初始化新實例中的屬性。 這個建構函式會使用 loadConfig 參數呼叫建FederationConfiguration.FederationConfiguration(Boolean)構函式true。

警告

在任何已設定的 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段必須在組態檔中的 <configSections> 專案下指定<section>，否則擲回例外狀況。

<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 建議您在組態區段中指定<federationConfiguration>system.identityModel.services至少一個元素未命名，或將其名稱設定為空字串。

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>