IHierarchicalDataSource.GetHierarchicalView(String) Método

Definição

Namespace:

System.Web.UI

Assembly:

System.Web.dll

Obtém o objeto auxiliar de exibição para a interface IHierarchicalDataSource para o caminho especificado.

public:
 System::Web::UI::HierarchicalDataSourceView ^ GetHierarchicalView(System::String ^ viewPath);

public System.Web.UI.HierarchicalDataSourceView GetHierarchicalView (string viewPath);

abstract member GetHierarchicalView : string -> System.Web.UI.HierarchicalDataSourceView

Public Function GetHierarchicalView (viewPath As String) As HierarchicalDataSourceView

Parâmetros

viewPath

String

O caminho hierárquico da exibição a ser recuperada.

Retornos

HierarchicalDataSourceView

Retorna um HierarchicalDataSourceView que representa uma única exibição dos dados no nível hierárquico identificado pelo parâmetro viewPath.

Exemplos

O exemplo de código a seguir demonstra como substituir o GetHierarchicalView método em uma classe que estende a HierarchicalDataSourceControl classe para recuperar um objeto fortemente tipado HierarchicalDataSourceView para um caminho hierárquico exclusivo. A FileSystemDataSource implementação da classe de GetHierarchicalView recupera um FileSystemDataSourceView objeto para um caminho do sistema de arquivos especificado. Este exemplo de código faz parte de um exemplo maior fornecido para a HierarchicalDataSourceControl classe.

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;

public class FileSystemDataSource :
    HierarchicalDataSourceControl, IHierarchicalDataSource
{
    private FileSystemDataSourceView view = null;

    public FileSystemDataSource() : base() { }

    protected override HierarchicalDataSourceView
        GetHierarchicalView(string viewPath)
    {
        view = new FileSystemDataSourceView(viewPath);
        return view;
    }
}

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

    Public Class FileSystemDataSource
        Inherits HierarchicalDataSourceControl

        Public Sub New()
        End Sub

        Private view As FileSystemDataSourceView = Nothing

        Protected Overrides Function GetHierarchicalView( _
            ByVal viewPath As String) As HierarchicalDataSourceView

            view = New FileSystemDataSourceView(viewPath)
            Return view
        End Function

    End Class

Comentários

A IHierarchicalDataSource interface, como a IDataSource interface, define um método que os controles hierárquicos da fonte de dados usam para recuperar uma exibição de fonte de dados. Como todos os DataSourceView objetos auxiliares associados a controles de fonte de dados, um HierarchicalDataSourceView objeto define as operações que a fonte de dados pode executar com os dados subjacentes. No entanto, embora os controles de fonte de dados que representam dados tabulares normalmente tenham apenas uma exibição nomeada, controles de fonte de dados hierárquicos dão suporte a uma exibição para cada nível de dados hierárquicos que o controle da fonte de dados representa. O nível de dados hierárquicos é identificado por um caminho hierárquico exclusivo, passado como o viewPath parâmetro.

Confira também

• DataSourceView
• HierarchicalDataSourceView