IHierarchicalDataSource.GetHierarchicalView メソッド

.NET Framework クラス ライブラリ リファレンス

IHierarchicalDataSource.GetHierarchicalView メソッド

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

IHierarchicalDataSource インターフェイスに対する、指定されたパスのビュー ヘルパー オブジェクトを取得します。

名前空間: System.Web.UI
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Function GetHierarchicalView ( _
    viewPath As String _
) As HierarchicalDataSourceView

Visual Basic (使用法)

Dim instance As IHierarchicalDataSource
Dim viewPath As String
Dim returnValue As HierarchicalDataSourceView

returnValue = instance.GetHierarchicalView(viewPath)

C#

HierarchicalDataSourceView GetHierarchicalView (
    string viewPath
)

C++

HierarchicalDataSourceView^ GetHierarchicalView (
    String^ viewPath
)

J#

HierarchicalDataSourceView GetHierarchicalView (
    String viewPath
)

JScript

function GetHierarchicalView (
    viewPath : String
) : HierarchicalDataSourceView

パラメータ

viewPath

取得するビューの階層パス。

戻り値
viewPath パラメータで識別される階層レベルのデータの 1 つのビューを表す HierarchicalDataSourceView を返します。

解説

IHierarchicalDataSource インターフェイスは、IDataSource インターフェイスと同様、データ ソース ビューを取得するために階層データ ソース コントロールが使用するメソッドを定義します。データ ソース コントロールに関連付けられるすべての DataSourceView ヘルパー オブジェクトと同様、HierarchicalDataSourceView オブジェクトは、基のデータに対してデータ ソースが実行できる操作を定義します。ただし、表形式のデータを表すデータ ソース コントロールは通常、1 つの名前付きビューに関連付けられるのに対して、階層データ ソース コントロールは、そのデータ ソース コントロールが表す階層データのレベルごとにビューをサポートします。階層データのレベルは一意の階層パスによって識別され、このパスは viewPath パラメータとして渡されます。

使用例

HierarchicalDataSourceControl クラスの拡張クラスで、GetHierarchicalView メソッドをオーバーライドして、一意の階層パスに対して、厳密に型指定された HierarchicalDataSourceView オブジェクトを取得する方法を次のコード例に示します。FileSystemDataSource クラスの GetHierarchicalView 実装により、指定されたファイル システム パスに対して FileSystemDataSourceView オブジェクトが取得されます。このコード例は、HierarchicalDataSourceControl クラスのトピックで取り上げているコード例の一部分です。

Visual Basic

Imports System
Imports System.Collections
Imports System.IO
Imports System.Runtime.InteropServices
Imports System.Security.Permissions
Imports System.Web
Imports System.Web.UI
Imports System.Web.UI.WebControls

Namespace Samples.AspNet

<AspNetHostingPermission(SecurityAction.Demand, Level:=AspNetHostingPermissionLevel.Minimal)>
 _
Public Class FileSystemDataSource
   Inherits HierarchicalDataSourceControl

   Public Sub New()
   End Sub 'New
   ' Return a strongly typed view for the current data source control.
   Private view As FileSystemDataSourceView
 = Nothing

   Protected Overrides Function
 GetHierarchicalView(viewPath As String) As
 HierarchicalDataSourceView
      If view Is Nothing
 Then
         view = New FileSystemDataSourceView(viewPath)
      End If
      Return view
   End Function 'GetHierarchicalView

End Class 'FileSystemDataSource

C#

using System;
using System.Collections;
using System.IO;
using System.Runtime.InteropServices;
using System.Security.Permissions;
using System.Web;
using System.Web.UI;
using System.Web.UI.WebControls;

[AspNetHostingPermission(SecurityAction.Demand, Level=AspNetHostingPermissionLevel.Minimal)]
public class FileSystemDataSource : HierarchicalDataSourceControl,
 IHierarchicalDataSource
{
    public FileSystemDataSource() : base()
 {}

    // Return a strongly typed view for the current data source control.
    private FileSystemDataSourceView view = null;
    protected override HierarchicalDataSourceView GetHierarchicalView(string
 viewPath) {
        if (null == view) {
            view = new FileSystemDataSourceView(viewPath);
        }
        return view;
    }

    // The FileSystemDataSource can be used declaratively. To enable
    // declarative use, override the default implementation of
    // CreateControlCollection to return a ControlCollection that
    // you can add to.
    protected override ControlCollection CreateControlCollection()
 {
        return new ControlCollection(this);
    }
}

プラットフォーム

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

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
IHierarchicalDataSource インターフェイス
IHierarchicalDataSource メンバ
System.Web.UI 名前空間
DataSourceView クラス
HierarchicalDataSourceView クラス