XmlnsPrefixAttribute 類別

定義

命名空間:

System.Windows.Markup

組件:

System.Xaml.dll

識別在 XAML 檔案中撰寫項目和屬性 (序列化) 時，或與具有 XAML 編輯功能的設計環境互動時，要與 XAML 用法的 XAML 命名空間關聯的建議前置詞。

public ref class XmlnsPrefixAttribute sealed : Attribute

[System.AttributeUsage(System.AttributeTargets.Assembly, AllowMultiple=true)]
public sealed class XmlnsPrefixAttribute : Attribute

[<System.AttributeUsage(System.AttributeTargets.Assembly, AllowMultiple=true)>]
type XmlnsPrefixAttribute = class
    inherit Attribute

Public NotInheritable Class XmlnsPrefixAttribute
Inherits Attribute

繼承

Object

Attribute

XmlnsPrefixAttribute

屬性

AttributeUsageAttribute

備註

包含 XAML 的 XAML 處理器或架構，或任何執行 XAML 串行化的進程，通常應該採用建議的前置詞。 在原始 XAML 來源中的特定對應前置詞不會以某種方式保留在運行時間物件圖形中，或由架構或技術儲存的任何情況下，可能都需要前置詞。 架構可能會有特定喜好設定，以瞭解如何串行化自己的類型，以忽略其自有元件的建議前置詞;這可能是為了一致地升級預設 XAML 命名空間。 不過，這類架構仍應針對其 XAML 類型的可能第三方和工具使用方式，提供建議的前置詞。 See "Best Practice for XAML Designer Support or General Serialization" section below.

前置詞的一般建議是使用簡短字串，因為前置詞通常會套用至來自 XAML 命名空間的所有串行化專案。 前置詞字串長度可能會對串行化 XAML 輸出的大小產生明顯的影響。

如果所要求的前置詞已由另一個先前遇到的/串行化 XAML 命名空間標識碼使用中，則行為未指定， (行為會由每個個別的 XAML 處理器實作) 所指定。

在大部分情況下，只有在您也已針對相同的 XAML 命名空間套用元件中至少一個XmlnsDefinitionAttribute時，才適用XmlnsPrefixAttribute。

在舊版的 .NET Framework 中，這個類別存在於 WPF 特定的元件 WindowsBase 中。 在 .NET Framework 4 中，XmlnsPrefixAttribute位於 System.Xaml 元件中。 如需詳細資訊，請參閱 Types Migrated from WPF to System.Xaml。

XAML Designer 支援或一般串行化的最佳做法

即使您想要讓相關聯的 XAML 命名空間在架構或連結庫的大部分使用案例中成為預設 XAML 命名空間，您仍應指定非空白字串作為 XAML 命名空間的建議前置詞。 預設 XAML 命名空間資訊會包含在個別 XAML 檔案和 XAML 節點資料流中。 預設 XAML 命名空間及其定義方式，可以在指定的 XAML 來源中輕鬆進行個別案例串行化，而不使用 XmlnsPrefixAttribute。 不過， XmlnsPrefixAttribute 適用於 XAML 作者選擇將預設 XAML 命名空間對應至其他項目的情況。 在此案例中，內嵌在設計環境中的 XAML 文字編輯器可作為 XmlnsPrefixAttribute 初始 XAML 命名空間 xmlns 對應的提示。 或者，設計環境可以將 Just-In-Time 對應新增至支援 XAML，以進行設計隱喻，例如將物件從工具箱拖曳到可視化設計介面中。 此外，設計工具可以同時支援多個 XAML 啟用架構，而且具有依賴 #DBB39C44E706842D0BF8E73636A320407 XAML 服務的常見 XAML 串行化程式，而不是架構特定的串行化。 如果 XmlnsPrefixAttribute XAML 在設計工具之間交換，或是在 XAML 編輯器與其他取用者之間交換，例如標記編譯程式或其他串行化，則為這些案例指定 ，有助於讓型別的 XAML 使用方式更具可攜性和健全性。

建構函式

XmlnsPrefixAttribute(String, String)

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

屬性

Prefix	取得此屬性相關聯的建議前置詞。
TypeId	在衍生類別中實作時，取得這個 Attribute 的唯一識別碼。 (繼承來源 Attribute)
XmlNamespace	取得此屬性相關聯的 XAML 命名空間識別項。

方法

Equals(Object)	傳回值，這個值指出此執行個體是否與指定的物件相等。 (繼承來源 Attribute)
GetHashCode()	傳回這個執行個體的雜湊碼。 (繼承來源 Attribute)
GetType()	取得目前執行個體的 Type。 (繼承來源 Object)
IsDefaultAttribute()	在衍生類別中覆寫時，表示這個執行個體的值是衍生類別的預設值。 (繼承來源 Attribute)
Match(Object)	在衍生類別中覆寫時，會傳回值，表示這個執行個體是否等於指定物件。 (繼承來源 Attribute)
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
ToString()	傳回代表目前物件的字串。 (繼承來源 Object)

另請參閱

• 自定義類型和連結庫的 XAML 相關 CLR 屬性
• 定義與 .NET XAML 服務搭配使用的自定義類型
• XAML 服務