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> ，以初始化新實例中的屬性。 這個建構函式會FederationConfiguration.FederationConfiguration(Boolean)使用 參數true呼叫建構函式loadConfig。

警告

在任何已設定的 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>  

如果 是 loadConfigtrue 且只指定單 <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>