IHierarchicalDataSource.GetHierarchicalView メソッドとは何？わかりやすく解説 Weblio辞書

.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)

HierarchicalDataSourceView GetHierarchicalView (
    string viewPath
)

C++

HierarchicalDataSourceView^ GetHierarchicalView (
    String^ viewPath
)

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

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);
    }
}