HierarchicalDataSourceConverter 類別

定義

命名空間:

System.Web.UI.Design

組件:

System.Design.dll

提供型別轉換子 (Type Converter)，可擷取目前元件能夠存取的階層式資料來源。

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 提供方法，可用來擷取目前設計時間元件可存取的階層式數據源清單。

Microsoft Visual Studio 會 HierarchicalDataSourceConverter 使用類型轉換器來提供出現在 [ 屬性 ] 視窗中數據源清單中的值。

警告

您不應該直接存取類型轉換器。 請改用 TypeDescriptor 類別呼叫適當的轉換器。 如需詳細資訊，請參閱 中的 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[])	使用指定的內容和屬性 (attribute)，傳回由該值參數所指定之陣列類型的屬性 (property) 集合。 (繼承來源 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
• 如何：實作類型轉換子