共用方式為


FederationConfiguration 建構函式

定義

初始化 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)

選擇性地從組態檔的 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 表示要初始化為預設值。

例外狀況

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> 項目的名稱。

例外狀況

組態檔沒有定義這個 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>

適用於