Configuration.SetMetadata(String, Object) 方法

定義

命名空間:

Microsoft.Web.Administration

組件:

Microsoft.Web.Administration.dll

設定 IIS 7 組態系統中的中繼資料。

public:
 void SetMetadata(System::String ^ metadataType, System::Object ^ value);

public void SetMetadata (string metadataType, object value);

member this.SetMetadata : string * obj -> unit

Public Sub SetMetadata (metadataType As String, value As Object)

參數

metadataType

String

要設定之中繼資料的名稱。

value

Object

要指派給中繼資料的值。

範例

下列範例會設定 參數所 metadataType 指定類型的中繼資料。

public void GetSetMetaData(ServerManager manager)
{
    //Configuration config = manager.GetAdministrationConfiguration();
    Configuration config = manager.GetApplicationHostConfiguration();
    config.SetMetadata("expandEnvironmentStrings", true);
}

備註

如果您針對不存在 metadataType 的 呼叫 方法， SetMetadata 就會發生錯誤。

下表顯示您可以設定的中繼資料。

中繼資料	Description
availableSections	傳回以逗號分隔的字串系列，指定架構中定義之所有可用管理區段的名稱。 這包括可在 inetsrv/config/schema 目錄中找到架構的任何區段，不論區段是否在 <configSections> 組態區段中註冊。
disableExtensions	預設值為 false。
expandEnvironmentStrings	預設值為 false。 判斷是否要以預設格式傳回環境變數 (，例如 %WINDIR%) 或其展開格式 (，例如 D：\Windows\) 。 此旗標會在使用讀取系統時自動設定，而不是在使用寫入系統時設定。
ignoreInvalidDecryption	預設值為 true。 設定旗標，以在讀取組態區段時忽略不正確屬性。 這可讓組態系統在讀取具有無效屬性的區段時，不會引發錯誤。
ignoreInvalidRanges	預設值為 true。 設定旗標，以在讀取組態區段時忽略不正確屬性。 這可讓組態系統在讀取具有無效屬性範圍的區段時，不會引發錯誤。
ignoreInvalidAttributes	預設值為 false。 設定旗標，以在讀取組態區段時忽略不正確屬性。 這可讓組態系統在讀取具有不正確解密屬性的區段時，不會引發錯誤。
changeHandler	預設值為 null。 在系統套用任何設定變更時，啟用變更通知的監視。
pathMapper	會傳回 IAppHostPathMapper 介面，讓組態系統覆寫將用於指定實體路徑之組態檔的存取權，並選擇性地提供組態檔的新實體對應位置。
mappingExtension	會傳回 IAppHostMappingExtension 介面，讓組態系統取得虛擬路徑對應和月臺資訊。
hideExceptionPhysicalPath	預設值為 false。

另請參閱

• GetMetadata(String)