Configuration.SetMetadata(String, Object) 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
設定 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 。 |