NameReferenceConverter 類別

定義

命名空間:

System.Windows.Markup

組件:

System.Xaml.dll

提供型別轉換，以將字串名稱轉換為具有該名稱之物件的物件參考，或是從物件圖形傳回物件的名稱。

public ref class NameReferenceConverter : System::ComponentModel::TypeConverter

public class NameReferenceConverter : System.ComponentModel.TypeConverter

type NameReferenceConverter = class
    inherit TypeConverter

Public Class NameReferenceConverter
Inherits TypeConverter

繼承

Object

TypeConverter

NameReferenceConverter

備註

這個類別提供兩個服務周圍的類型轉換器包裝函式。

實作 ConvertFrom 會使用 IXamlNameResolver 內容中的服務，以在 XAML 中依名稱執行物件的解析。 這是 .NET Framework XAML 服務中相關 XAML 讀取器和 XAML 寫入器實作的一部分。 此轉換器的適當功能需要 IXamlNameResolver 服務可從服務內容取得。

實 ConvertTo 作會使用 IXamlNameProvider 內容中的服務，在儲存/串行化期間執行對象的參考名稱解析。 這是相關讀取器和寫入器實作及其內容的一部分。 此轉換器的適當功能需要有可用的基礎 IXamlNameProvider 服務。

這個類型轉換器實作對 TypeConverter 基底類型而言是不典型的，因為它的範圍不是離散轉換類型。 只要該物件可以在 XAML 中指派名稱，而且支援內容具有傳回結果所需的服務，它就可以將任何物件轉換成參考名稱。

作為一般服務支援的一部分，和的 XamlObjectWriterXamlXmlWriterIXamlNameProvider System.Xaml 基底實作可供 IXamlNameResolver 使用。NameReferenceConverter 這些服務的名稱基礎會使用 x:Name 或 RuntimeNamePropertyAttribute 屬性化別名屬性。

建構函式

NameReferenceConverter()

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

方法

CanConvertFrom(ITypeDescriptorContext, Type)	傳回值，這個值指出這個轉換子是否可以將某個型別的物件轉換為其他物件。
CanConvertFrom(Type)	傳回值，指出這個轉換子是否可將指定之型別的物件轉換為這個轉換子的型別。 (繼承來源 TypeConverter)
CanConvertTo(ITypeDescriptorContext, Type)	傳回值，這個值表示轉換子是否可以將物件轉換為指定的目的型別。
CanConvertTo(Type)	傳回值，指出這個轉換子是否可以將物件轉換成指定的型別。 (繼承來源 TypeConverter)
ConvertFrom(ITypeDescriptorContext, CultureInfo, Object)	使用指定的內容和文化特性 (Culture) 資訊，將提供的物件轉換為其他物件。
ConvertFrom(Object)	會將指定值轉換為這個轉換子的型別。 (繼承來源 TypeConverter)
ConvertFromInvariantString(ITypeDescriptorContext, String)	會使用不區分的文化特性和指定的內容，將指定的字串轉換為這個轉換子的型別。 (繼承來源 TypeConverter)
ConvertFromInvariantString(String)	會使用不因文化特性而異，將指定字串轉換為這個轉換子的型別。 (繼承來源 TypeConverter)
ConvertFromString(ITypeDescriptorContext, CultureInfo, String)	會使用指定內容和文化特性資訊，將指定文字轉換為物件。 (繼承來源 TypeConverter)
ConvertFromString(ITypeDescriptorContext, String)	會使用指定的內容，將指定文字轉換為物件。 (繼承來源 TypeConverter)
ConvertFromString(String)	會將指定的文字轉換成物件。 (繼承來源 TypeConverter)
ConvertTo(ITypeDescriptorContext, CultureInfo, Object, Type)	將物件轉換成指定的型別。 這適合用來傳回物件圖形中物件的 XAML 參考名稱。
ConvertTo(Object, Type)	會使用引數，將指定值物件轉換成指定型別。 (繼承來源 TypeConverter)
ConvertToInvariantString(ITypeDescriptorContext, Object)	會使用指定的內容，將指定值轉換成不因文化特性而異的字串表示。 (繼承來源 TypeConverter)
ConvertToInvariantString(Object)	會將指定值轉換成不因文化特性而異的字串表示。 (繼承來源 TypeConverter)
ConvertToString(ITypeDescriptorContext, CultureInfo, Object)	會使用指定的內容和文化特性資訊，將指定值轉換為字串表示。 (繼承來源 TypeConverter)
ConvertToString(ITypeDescriptorContext, Object)	會使用指定的內容，將指定值轉換為字串表示。 (繼承來源 TypeConverter)
ConvertToString(Object)	會將指定值轉換成字串表示。 (繼承來源 TypeConverter)
CreateInstance(IDictionary)	重新建立 Object，需為物件提供一組屬性值。 (繼承來源 TypeConverter)
CreateInstance(ITypeDescriptorContext, IDictionary)	使用指定的內容，建立與這個 TypeConverter 相關聯之類型的執行個體，並為物件提供一組屬性值。 (繼承來源 TypeConverter)
Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
GetConvertFromException(Object)	傳回要在無法執行轉換時擲回的例外狀況。 (繼承來源 TypeConverter)
GetConvertToException(Object, Type)	傳回要在無法執行轉換時擲回的例外狀況。 (繼承來源 TypeConverter)
GetCreateInstanceSupported()	傳回值，指出在這個物件上變更值時是否需要呼叫 CreateInstance(IDictionary) 方法來建立新值。 (繼承來源 TypeConverter)
GetCreateInstanceSupported(ITypeDescriptorContext)	傳回在這個物件上變更值是否需要呼叫 CreateInstance(IDictionary) 來建立新的值，並使用指定的內容。 (繼承來源 TypeConverter)
GetHashCode()	做為預設雜湊函式。 (繼承來源 Object)
GetProperties(ITypeDescriptorContext, Object)	會使用指定的內容，傳回由值參數所指定之陣列型別的屬性集合。 (繼承來源 TypeConverter)
GetProperties(ITypeDescriptorContext, Object, Attribute[])	使用指定的內容和屬性 (attribute)，傳回由該值參數所指定之陣列類型的屬性 (property) 集合。 (繼承來源 TypeConverter)
GetProperties(Object)	傳回由值參數所指定的陣列型別的屬性集合。 (繼承來源 TypeConverter)
GetPropertiesSupported()	傳回值，指出這個物件是否支援屬性。 (繼承來源 TypeConverter)
GetPropertiesSupported(ITypeDescriptorContext)	使用指定的內容，傳回這個物件是否支援屬性。 (繼承來源 TypeConverter)
GetStandardValues()	從為這個型別轉換子所設計的資料型別預設內容中，會傳回標準值的集合。 (繼承來源 TypeConverter)
GetStandardValues(ITypeDescriptorContext)	提供格式內容時，傳回此類型轉換子所針對資料類型的標準值集合。 (繼承來源 TypeConverter)
GetStandardValuesExclusive()	傳回值，指出從 GetStandardValues() 所傳回的標準值集合是否為獨佔清單。 (繼承來源 TypeConverter)
GetStandardValuesExclusive(ITypeDescriptorContext)	使用指定的內容，傳回從 GetStandardValues() 所傳回的標準值集合是否為可能值的獨占清單。 (繼承來源 TypeConverter)
GetStandardValuesSupported()	傳回這個物件是否支援可以從清單中選取的標準值集合。 (繼承來源 TypeConverter)
GetStandardValuesSupported(ITypeDescriptorContext)	會使用指定的內容傳回，這個物件是否支援可從清單中挑選的標準值集合。 (繼承來源 TypeConverter)
GetType()	取得目前執行個體的 Type。 (繼承來源 Object)
IsValid(ITypeDescriptorContext, Object)	傳回指定值物件對這個類型和指定的內容是否有效。 (繼承來源 TypeConverter)
IsValid(Object)	會傳回指定值物件是否對這個型別有效。 (繼承來源 TypeConverter)
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
SortProperties(PropertyDescriptorCollection, String[])	排序屬性的集合。 (繼承來源 TypeConverter)
ToString()	傳回代表目前物件的字串。 (繼承來源 Object)

另請參閱

• XAML 的類型轉換子和標記延伸
• XAML 服務