NameReferenceConverter 类

定义

提供类型转换,以将字符串名称转换成对具有该名称的对象的对象引用,或返回对象图中对象的名称。Provides type conversion to convert a string name into an object reference to the object with that name, or to return the name of an object from the object graph.

public ref class NameReferenceConverter : System::ComponentModel::TypeConverter
public class NameReferenceConverter : System.ComponentModel.TypeConverter
type NameReferenceConverter = class
    inherit TypeConverter
Public Class NameReferenceConverter
Inherits TypeConverter
继承
NameReferenceConverter

注解

此类提供围绕两个服务的类型转换器包装。This class provides a type converter wrapper around two services.

ConvertFrom实现使用IXamlNameResolver上下文中的服务在 XAML 中按名称执行对象的解析。The ConvertFrom implementation uses IXamlNameResolver service from context to perform the resolution of an object by name in XAML. 这是适用于 xaml 读取器和 XAML 编写器实现 .NET Framework XAML 服务的一部分。This is part of the relevant XAML reader and XAML writer implementations in .NET Framework XAML Services. 此转换器的正确功能需要服务上下文IXamlNameResolver中提供该服务。Proper function of this converter requires that the IXamlNameResolver service is available from service context.

ConvertTo实现使用IXamlNameProvider上下文中的服务在保存/序列化过程中对对象的引用名称进行解析。The ConvertTo implementation uses IXamlNameProvider service from context to perform the resolution of a reference name for an object during save/serialization. 这是相关读取器和编写器实现及其上下文的一部分。This is part of the relevant reader and writer implementations and their context. 此转换器的正确功能需要提供基础IXamlNameProvider服务。Proper function of this converter requires that there be an underlying IXamlNameProvider service available.

此类型转换器实现对于TypeConverter基类型是典型的, 因为它的作用域不是离散的转换类型。This type converter implementation is atypical for the TypeConverter base type because it is not scoped to a discrete conversion type. 它可能会将任何对象转换为引用名称, 并从引用名称转换到该对象, 只要该对象可能在 XAML 中分配有名称, 并且支持上下文具有返回结果所必需的服务。It can potentially convert any object to and from a referencing name so long as that object could have a name assigned to it in XAML, and the supporting context has the necessary services to return results.

作为常规服务支持的一部分, XamlObjectWriterXamlXmlWriter的系统 Xaml 基实现提供IXamlNameProviderIXamlNameResolver服务供使用NameReferenceConverterAs part of general services support, the System.Xaml base implementation of XamlObjectWriter and XamlXmlWriter provide IXamlNameProvider and IXamlNameResolver services for use by NameReferenceConverter. 这些服务的名称基础使用x:Name RuntimeNamePropertyAttribute或特性化别名属性。The name basis for these services uses either x:Name or a RuntimeNamePropertyAttribute attributed alias property.

构造函数

NameReferenceConverter()

初始化 NameReferenceConverter 类的新实例。Initializes a new instance of the NameReferenceConverter class.

方法

CanConvertFrom(ITypeDescriptorContext, Type)

返回该转换器是否可以将一种类型的对象转换为另一个对象。Returns whether this converter can convert an object of one type to another object.

CanConvertFrom(Type)

返回该转换器是否可以将给定类型的对象转换为此转换器的类型。Returns whether this converter can convert an object of the given type to the type of this converter.

(继承自 TypeConverter)
CanConvertTo(ITypeDescriptorContext, Type)

返回一个值,该值指示转换器能否将对象转换为指定的目标类型。Returns a value that indicates whether the converter can convert an object to the specified destination type.

CanConvertTo(Type)

返回此转换器是否可将该对象转换为指定的类型。Returns whether this converter can convert the object to the specified type.

(继承自 TypeConverter)
ConvertFrom(ITypeDescriptorContext, CultureInfo, Object)

使用指定的上下文和区域性信息将提供的对象转换为另一个对象。Converts the provided object to another object, using the specified context and culture information.

ConvertFrom(Object)

将给定值转换为此转换器的类型。Converts the given value to the type of this converter.

(继承自 TypeConverter)
ConvertFromInvariantString(ITypeDescriptorContext, String)

使用不变区域性和指定上下文将给定字符串转换为此转换器的类型。Converts the given string to the type of this converter, using the invariant culture and the specified context.

(继承自 TypeConverter)
ConvertFromInvariantString(String)

使用不变区域性将给定字符串转换为此转换器的类型。Converts the given string to the type of this converter, using the invariant culture.

(继承自 TypeConverter)
ConvertFromString(ITypeDescriptorContext, CultureInfo, String)

使用指定的上下文和区域性信息将给定的文本转换为对象。Converts the given text to an object, using the specified context and culture information.

(继承自 TypeConverter)
ConvertFromString(ITypeDescriptorContext, String)

使用指定的上下文将给定的文本转换为对象。Converts the given text to an object, using the specified context.

(继承自 TypeConverter)
ConvertFromString(String)

将指定文本转换为对象。Converts the specified text to an object.

(继承自 TypeConverter)
ConvertTo(ITypeDescriptorContext, CultureInfo, Object, Type)

将对象转换为指定类型。Converts an object to the specified type. 这用于为对象图形中的对象返回 XAML 引用名称。This is intended to return XAML reference names for objects in an object graph.

ConvertTo(Object, Type)

使用参数将给定的值对象转换为指定的类型。Converts the given value object to the specified type, using the arguments.

(继承自 TypeConverter)
ConvertToInvariantString(ITypeDescriptorContext, Object)

使用指定的上下文将指定的值转换为区域性不变的字符串表示形式。Converts the specified value to a culture-invariant string representation, using the specified context.

(继承自 TypeConverter)
ConvertToInvariantString(Object)

将指定值转换为区域性不变的字符串表示形式。Converts the specified value to a culture-invariant string representation.

(继承自 TypeConverter)
ConvertToString(ITypeDescriptorContext, CultureInfo, Object)

使用指定的上下文和区域性信息将给定的值转换为字符串表示形式。Converts the given value to a string representation, using the specified context and culture information.

(继承自 TypeConverter)
ConvertToString(ITypeDescriptorContext, Object)

使用给定的上下文将给定的值转换为字符串表示形式。Converts the given value to a string representation, using the given context.

(继承自 TypeConverter)
ConvertToString(Object)

将指定值转换为字符串表示形式。Converts the specified value to a string representation.

(继承自 TypeConverter)
CreateInstance(IDictionary)

在给定 Object 的一组属性值的情况下重新创建该对象。Re-creates an Object given a set of property values for the object.

(继承自 TypeConverter)
CreateInstance(ITypeDescriptorContext, IDictionary)

给定该对象的一组属性值,使用指定上下文创建与此 TypeConverter 相关联的类型的实例。Creates an instance of the type that this TypeConverter is associated with, using the specified context, given a set of property values for the object.

(继承自 TypeConverter)
Equals(Object)

确定指定的对象是否等于当前对象。Determines whether the specified object is equal to the current object.

(继承自 Object)
GetConvertFromException(Object)

返回当转换无法执行时所引发的异常。Returns an exception to throw when a conversion cannot be performed.

(继承自 TypeConverter)
GetConvertToException(Object, Type)

返回当转换无法执行时所引发的异常。Returns an exception to throw when a conversion cannot be performed.

(继承自 TypeConverter)
GetCreateInstanceSupported()

返回更改此对象的值是否求调用 CreateInstance(IDictionary) 方法来创建新值。Returns whether changing a value on this object requires a call to the CreateInstance(IDictionary) method to create a new value.

(继承自 TypeConverter)
GetCreateInstanceSupported(ITypeDescriptorContext)

返回一个结果,即更改此对象上的某个值是否需要调用 CreateInstance(IDictionary) 以使用指定的上下文创建新值。Returns whether changing a value on this object requires a call to CreateInstance(IDictionary) to create a new value, using the specified context.

(继承自 TypeConverter)
GetHashCode()

用作默认哈希函数。Serves as the default hash function.

(继承自 Object)
GetProperties(ITypeDescriptorContext, Object)

使用指定的上下文返回值参数指定的数组类型的属性的集合。Returns a collection of properties for the type of array specified by the value parameter, using the specified context.

(继承自 TypeConverter)
GetProperties(ITypeDescriptorContext, Object, Attribute[])

使用指定的上下文和特性返回由该值参数指定的数组类型的属性集合。Returns a collection of properties for the type of array specified by the value parameter, using the specified context and attributes.

(继承自 TypeConverter)
GetProperties(Object)

返回由值参数指定的数组类型的属性集合。Returns a collection of properties for the type of array specified by the value parameter.

(继承自 TypeConverter)
GetPropertiesSupported()

返回此对象是否支持属性。Returns whether this object supports properties.

(继承自 TypeConverter)
GetPropertiesSupported(ITypeDescriptorContext)

通过使用指定的上下文,返回此对象是否支持属性。Returns whether this object supports properties, using the specified context.

(继承自 TypeConverter)
GetStandardValues()

从默认的上下文返回此类型转换器设计用于的数据类型的标准值集合。Returns a collection of standard values from the default context for the data type this type converter is designed for.

(继承自 TypeConverter)
GetStandardValues(ITypeDescriptorContext)

当与格式上下文一起提供时,返回此类型转换器设计用于的数据类型的标准值集合。Returns a collection of standard values for the data type this type converter is designed for when provided with a format context.

(继承自 TypeConverter)
GetStandardValuesExclusive()

返回从 GetStandardValues() 返回的标准值的集合是否为独占列表。Returns whether the collection of standard values returned from GetStandardValues() is an exclusive list.

(继承自 TypeConverter)
GetStandardValuesExclusive(ITypeDescriptorContext)

使用指定的上下文返回从 GetStandardValues() 返回的标准值的集合是否为可能值的独占列表。Returns whether the collection of standard values returned from GetStandardValues() is an exclusive list of possible values, using the specified context.

(继承自 TypeConverter)
GetStandardValuesSupported()

返回此对象是否支持可以从列表中选取的值的标准集。Returns whether this object supports a standard set of values that can be picked from a list.

(继承自 TypeConverter)
GetStandardValuesSupported(ITypeDescriptorContext)

使用指定的上下文返回此对象是否支持可以从列表中选取的标准值集。Returns whether this object supports a standard set of values that can be picked from a list, using the specified context.

(继承自 TypeConverter)
GetType()

获取当前实例的 TypeGets the Type of the current instance.

(继承自 Object)
IsValid(ITypeDescriptorContext, Object)

返回给定的值对象是否对此类型和对指定的上下文有效。Returns whether the given value object is valid for this type and for the specified context.

(继承自 TypeConverter)
IsValid(Object)

返回给定值对象对于此类型是否有效。Returns whether the given value object is valid for this type.

(继承自 TypeConverter)
MemberwiseClone()

创建当前 Object 的浅表副本。Creates a shallow copy of the current Object.

(继承自 Object)
SortProperties(PropertyDescriptorCollection, String[])

对属性的集合进行排序。Sorts a collection of properties.

(继承自 TypeConverter)
ToString()

返回一个表示当前对象的 string。Returns a string that represents the current object.

(继承自 Object)

适用于

另请参阅