Export (0) Print
Expand All

HierarchicalDataSourceConverter Class

Provides a type converter that can retrieve a list of the hierarchical data sources that are accessible to the current component.

Namespace: System.Web.UI.Design
Assembly: System.Design (in system.design.dll)

public class HierarchicalDataSourceConverter : DataSourceConverter
public class HierarchicalDataSourceConverter extends DataSourceConverter
public class HierarchicalDataSourceConverter extends DataSourceConverter
Not applicable.

The HierarchicalDataSourceConverter class provides methods that can be used to retrieve a list of the hierarchical data sources that are accessible to the current design-time component.

The HierarchicalDataSourceConverter type converter is used by Microsoft Visual Studio to provide the values that appear in the list of data sources in the Properties window.

Caution noteCaution:

You should never access a type converter directly. Instead, call the appropriate converter by using the TypeDescriptor class. For more information, see the examples in TypeConverter.

For more information about type converters, see the TypeConverter base class and How to: Implement a Type Converter.

The following code example demonstrates how to associate a HierarchicalDataSourceConverter with a hierarchical data source property that is contained within a custom control.

[
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.
    // ...

}

System.Object
   System.ComponentModel.TypeConverter
     System.Web.UI.Design.DataSourceConverter
      System.Web.UI.Design.HierarchicalDataSourceConverter

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Windows 98, Windows Server 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0

Community Additions

ADD
Show:
© 2015 Microsoft