HierarchicalDataSourceConverter 类

定义

命名空间:

System.Web.UI.Design

程序集:

System.Design.dll

提供类型转换器，可检索当前组件所能访问的分层数据源的列表。

public ref class HierarchicalDataSourceConverter : System::Web::UI::Design::DataSourceConverter

public class HierarchicalDataSourceConverter : System.Web.UI.Design.DataSourceConverter

type HierarchicalDataSourceConverter = class
    inherit DataSourceConverter

Public Class HierarchicalDataSourceConverter
Inherits DataSourceConverter

继承

Object

TypeConverter

DataSourceConverter

HierarchicalDataSourceConverter

示例

下面的代码示例演示如何将包含 HierarchicalDataSourceConverter 于自定义控件中的分层数据源属性相关联。

[
ToolboxData("<{0}:MyCustomHierarchicalControl runat=server> </{0}:MyCustomHierarchicalControl>")
] 
public class MyCustomHierarchicalControl : TreeView 
{        
    private object _dataSource;

    [TypeConverter(typeof(HierarchicalDataSourceConverter))]
    public override object DataSource
    {
        get
        {
            return _dataSource;
        }
        set
        {
            if (value != null) 
            {
                ValidateDataSource(value);
            }
            _dataSource = value;
            OnDataPropertyChanged();
        }
    }

    // Define rest of custom control implementation.
    // ...
}

注解

该 HierarchicalDataSourceConverter 类提供了可用于检索当前设计时组件可访问的分层数据源列表的方法。

类型HierarchicalDataSourceConverter转换器由Microsoft Visual Studio用来提供“属性” 窗口中数据源列表中显示的值。

注意

不应直接访问类型转换器。 而是使用 TypeDescriptor 类调用适当的转换器。 For more information, see the examples in TypeConverter.

有关类型转换器的详细信息，请参阅 TypeConverter 基类和 如何：实现类型转换器。

构造函数

HierarchicalDataSourceConverter()

初始化 HierarchicalDataSourceConverter 类的新实例。

方法

CanConvertFrom(ITypeDescriptorContext, Type)	获取一个值，该值指示转换器是否可以将指定源类型的对象转换为转换器的本机类型。 (继承自 DataSourceConverter)
CanConvertFrom(Type)	返回该转换器是否可以将给定类型的对象转换为此转换器的类型。 (继承自 TypeConverter)
CanConvertTo(ITypeDescriptorContext, Type)	返回此转换器能否使用指定上下文将对象转换为指定类型。 (继承自 TypeConverter)
CanConvertTo(Type)	返回此转换器是否可将该对象转换为指定的类型。 (继承自 TypeConverter)
ConvertFrom(ITypeDescriptorContext, CultureInfo, Object)	将指定对象转换为转换器的本机类型。 (继承自 DataSourceConverter)
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)	使用指定的上下文和区域性信息将给定值对象转换为指定的类型。 (继承自 TypeConverter)
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[])	使用指定的上下文和特性返回由该值参数指定的数组类型的属性集合。 (继承自 TypeConverter)
GetProperties(Object)	返回由值参数指定的数组类型的属性集合。 (继承自 TypeConverter)
GetPropertiesSupported()	返回此对象是否支持属性。 (继承自 TypeConverter)
GetPropertiesSupported(ITypeDescriptorContext)	通过使用指定的上下文，返回此对象是否支持属性。 (继承自 TypeConverter)
GetStandardValues()	从默认的上下文返回此类型转换器设计用于的数据类型的标准值集合。 (继承自 TypeConverter)
GetStandardValues(ITypeDescriptorContext)	获取控件可以访问的标准数据源。 (继承自 DataSourceConverter)
GetStandardValuesExclusive()	返回从 GetStandardValues() 返回的标准值的集合是否为独占列表。 (继承自 TypeConverter)
GetStandardValuesExclusive(ITypeDescriptorContext)	获取一个值，该值指示从 GetStandardValues() 返回的标准值集合是否为所有可能值的列表。 (继承自 DataSourceConverter)
GetStandardValuesSupported()	返回此对象是否支持可以从列表中选取的标准值集。 (继承自 TypeConverter)
GetStandardValuesSupported(ITypeDescriptorContext)	获取一个值，该值指示转换器是否支持可从列表中选取的一组标准值。 (继承自 DataSourceConverter)
GetType()	获取当前实例的 Type。 (继承自 Object)
IsValid(ITypeDescriptorContext, Object)	返回给定的值对象是否对此类型和对指定的上下文有效。 (继承自 TypeConverter)
IsValid(Object)	返回给定值对象对于此类型是否有效。 (继承自 TypeConverter)
IsValidDataSource(IComponent)	指示指定组件是否为此转换器的有效数据源。
MemberwiseClone()	创建当前 Object 的浅表副本。 (继承自 Object)
SortProperties(PropertyDescriptorCollection, String[])	对属性的集合进行排序。 (继承自 TypeConverter)
ToString()	返回表示当前对象的字符串。 (继承自 Object)

另请参阅

• HierarchicalDataSourceControl
• HierarchicalDataSourceDesigner
• 如何：实现类型转换器