NameScope 類別

定義

命名空間:

System.Windows

組件:

WindowsBase.dll

實作 INameScope 方法的基礎 WPF 支援，這些方法可將「名稱-物件」對應儲存或擷取至特定 XAML 名稱範圍中。 新增附加屬性支援，以簡化在項目層級動態取得或設定 XAML 名稱範圍名稱。

public ref class NameScope : System::Collections::Generic::ICollection<System::Collections::Generic::KeyValuePair<System::String ^, System::Object ^>>, System::Collections::Generic::IDictionary<System::String ^, System::Object ^>, System::Collections::Generic::IEnumerable<System::Collections::Generic::KeyValuePair<System::String ^, System::Object ^>>, System::Windows::Markup::INameScopeDictionary

public class NameScope : System.Collections.Generic.ICollection<System.Collections.Generic.KeyValuePair<string,object>>, System.Collections.Generic.IDictionary<string,object>, System.Collections.Generic.IEnumerable<System.Collections.Generic.KeyValuePair<string,object>>, System.Windows.Markup.INameScopeDictionary

type NameScope = class
    interface ICollection<KeyValuePair<string, obj>>
    interface seq<KeyValuePair<string, obj>>
    interface IEnumerable
    interface IDictionary<string, obj>
    interface INameScope
    interface INameScopeDictionary

Public Class NameScope
Implements ICollection(Of KeyValuePair(Of String, Object)), IDictionary(Of String, Object), IEnumerable(Of KeyValuePair(Of String, Object)), INameScopeDictionary

繼承

Object

NameScope

實作

ICollection<KeyValuePair<String,Object>> ICollection<KeyValuePair<TKey,TValue>> IDictionary<String,Object> IEnumerable<KeyValuePair<String,Object>> IEnumerable<KeyValuePair<TKey,TValue>> IEnumerable<T> IEnumerable INameScopeDictionary

備註

這個類別會實作 XAML 的內建 XAML 名稱範圍支援，以進行 XAML 的 WPF 處理。 NameScope 協助根據剖析 XAML 建立初始 XAML 名稱範圍，例如具現化樣式和範本時。 它也支援透過 WPF XAML 處理器實作在一般 XAML 載入專案外部發生的進程建立 XAML 名稱範圍。

NameScope 通常更致力於提供基礎結構，而不是涉及使用 XAML 名稱範圍的常見用戶程式代碼案例。 在大部分情況下， FindName 公開 FrameworkElement 的方法和 FrameworkContentElement 更適當的方法會呼叫 以依 XAML 定義名稱搜尋元素。 Name和 FrameworkElementFrameworkContentElement 公開的屬性是更適當的屬性，可用來將初始名稱設定為標記屬性。

的各種 方法 NameScope 會由基底元素和其他類別使用，這些類別會維護 XAML 名稱範圍，以支援 RegisterName 和 FindName。 您通常只有在取代或增強基底元素行為時，才會在 類別中使用 NameScope API，以處理 XAML 頁面根元素的 XAML 名稱範圍，以及作為範本的一部分， (使用個別的 XAML 名稱範圍與頁面的其餘部分) 。

在 .NET Framework 4 中，NameScope提供集合介面實作，讓您可以存取 XAML 名稱範圍所持有的名稱集合，包括透過呼叫 Add 方法來新增至它。

如需 XAML 名稱範圍概念的詳細資訊，請參閱 WPF XAML 名稱範圍。

XAML 名稱範圍中的名稱必須使用特定文法來限制您可能用於 API 輸入的 NameScope 字串。 請參閱 XamlName 文法。

建構函式

NameScope()

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

欄位

NameScopeProperty

識別 NameScope 附加屬性。

屬性

Count	傳回這個 NameScope 中對應之名稱的集合內之項目數。
IsReadOnly	取得值，表示集合是否為唯讀。
Item[String]	取得或設定具有指定之索引鍵的項目。
Keys	取得 NameScope 字典中索引鍵的集合。
Values	取得 NameScope 字典中值的集合。

附加屬性

NameScope

取得或設定動態附加的 NameScope 執行個體。

方法

Add(KeyValuePair<String,Object>)	將項目新增至集合。
Add(String, Object)	將項目新增至集合。
Clear()	移除集合的所有項目。
Contains(KeyValuePair<String,Object>)	判斷集合是否包含指定的項目。
ContainsKey(String)	傳回提供的名稱是否已經存在這個 NameScope 中。
CopyTo(KeyValuePair<String,Object>[], Int32)	從特定的陣列索引開始，將集合的項目複製到陣列。
Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
FindName(String)	根據提供的名稱字串，傳回 NameScope 在 XAML 名稱範圍所維護的對應物件。
GetHashCode()	做為預設雜湊函式。 (繼承來源 Object)
GetNameScope(DependencyObject)	為 NameScope 附加屬性提供附加屬性 get 存取子。
GetType()	取得目前執行個體的 Type。 (繼承來源 Object)
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
RegisterName(String, Object)	將新的名稱-物件組註冊到目前的 XAML 名稱範圍。
Remove(KeyValuePair<String,Object>)	從集合中移除指定的物件。
Remove(String)	從集合移除指定之名稱的對應。
SetNameScope(DependencyObject, INameScope)	為 NameScope 附加屬性提供附加屬性 set 存取子。
ToString()	傳回代表目前物件的字串。 (繼承來源 Object)
TryGetValue(String, Object)	取得與指定索引鍵關聯的值。
UnregisterName(String)	從 XAML NameScope 中移除名稱/物件對應。

明確介面實作

IEnumerable.GetEnumerator()	傳回逐一查看集合的列舉值。
IEnumerable<KeyValuePair<String,Object>>.GetEnumerator()	傳回逐一查看集合的列舉值。

擴充方法

另請參閱

• INameScope