HierarchicalDataSourceView Класс

Определение

Представляет представление данных на узле или коллекции узов в иерархической структуре данных для элемента управления HierarchicalDataSourceControl.

public ref class HierarchicalDataSourceView abstract
public abstract class HierarchicalDataSourceView
type HierarchicalDataSourceView = class
Public MustInherit Class HierarchicalDataSourceView
Наследование
HierarchicalDataSourceView
Производный

Примеры

В следующем примере кода показано, как создать класс из HierarchicalDataSourceView класса для извлечения данных из хранилища иерархических данных, в данном случае файловой системы. FileSystemDataSourceViewКласс является строго типизированным HierarchicalDataSourceView экземпляром, который позволяет иерархическим элементам управления веб-сервера, таким как TreeView элемент управления, осуществлять привязку к FileSystemDataSource элементу управления и отображать сведения о файловой системе. в целях безопасности сведения о файловой системе отображаются только в том случае, если элемент управления источника данных используется в локальном узле, прошедшем проверку подлинности сценарии и запускается только с виртуальным каталогом, в котором находится веб-формы страница с элементом управления источниками данных. В противном случае viewPath параметр, передаваемый конструктору, может использоваться для создания представления на основе текущего пути файловой системы. Этот пример кода является частью большого примера, приведенного для HierarchicalDataSourceControl класса.

public class FileSystemDataSourceView : HierarchicalDataSourceView
{
    private string _viewPath;

    public FileSystemDataSourceView(string viewPath)
    {
        HttpRequest currentRequest = HttpContext.Current.Request;
        if (viewPath == "")
        {
            _viewPath = currentRequest.MapPath(currentRequest.ApplicationPath);
        }
        else
        {
            _viewPath = Path.Combine(
                currentRequest.MapPath(currentRequest.ApplicationPath),
                viewPath);
        }
    }

    // Starting with the rootNode, recursively build a list of
    // FileSystemInfo nodes, create FileSystemHierarchyData
    // objects, add them all to the FileSystemHierarchicalEnumerable,
    // and return the list.
    public override IHierarchicalEnumerable Select()
    {
        HttpRequest currentRequest = HttpContext.Current.Request;

        // SECURITY: There are many security issues that can be raised
        // SECURITY: by exposing the file system structure of a Web server
        // SECURITY: to an anonymous user in a limited trust scenario such as
        // SECURITY: a Web page served on an intranet or the Internet.
        // SECURITY: For this reason, the FileSystemDataSource only
        // SECURITY: shows data when the HttpRequest is received
        // SECURITY: from a local Web server. In addition, the data source
        // SECURITY: does not display data to anonymous users.
        if (currentRequest.IsAuthenticated &&
            (currentRequest.UserHostAddress == "127.0.0.1" ||
             currentRequest.UserHostAddress == "::1"))
        {
            DirectoryInfo rootDirectory = new DirectoryInfo(_viewPath);
            if (!rootDirectory.Exists)
            {
                return null;
            }

            FileSystemHierarchicalEnumerable fshe =
                new FileSystemHierarchicalEnumerable();

            foreach (FileSystemInfo fsi
                in rootDirectory.GetFileSystemInfos())
            {
                fshe.Add(new FileSystemHierarchyData(fsi));
            }
            return fshe;
        }
        else
        {
            throw new NotSupportedException(
                "The FileSystemDataSource only " +
                "presents data in an authenticated, localhost context.");
        }
    }
}
Public Class FileSystemDataSourceView
    Inherits HierarchicalDataSourceView

    Private _viewPath As String

    Public Sub New(ByVal viewPath As String)
        Dim currentRequest As HttpRequest = HttpContext.Current.Request
        If viewPath = "" Then
            _viewPath = currentRequest.MapPath(currentRequest.ApplicationPath)
        Else
            _viewPath = Path.Combine(currentRequest.MapPath(currentRequest.ApplicationPath), viewPath)
        End If
    End Sub


    ' Starting with the rootNode, recursively build a list of
    ' FileSystemInfo nodes, create FileSystemHierarchyData
    ' objects, add them all to the FileSystemHierarchicalEnumerable,
    ' and return the list.
    Public Overrides Function [Select]() As IHierarchicalEnumerable
        Dim currentRequest As HttpRequest = HttpContext.Current.Request

        ' SECURITY: There are many security issues that can be raised
        ' SECURITY: by exposing the file system structure of a Web server
        ' SECURITY: to an anonymous user in a limited trust scenario such as
        ' SECURITY: a Web page served on an intranet or the Internet.
        ' SECURITY: For this reason, the FileSystemDataSource only
        ' SECURITY: shows data when the HttpRequest is received
        ' SECURITY: from a local Web server. In addition, the data source
        ' SECURITY: does not display data to anonymous users.
        If currentRequest.IsAuthenticated AndAlso _
            (currentRequest.UserHostAddress = "127.0.0.1" OrElse _
             currentRequest.UserHostAddress = "::1") Then

            Dim rootDirectory As New DirectoryInfo(_viewPath)

            Dim fshe As New FileSystemHierarchicalEnumerable()

            Dim fsi As FileSystemInfo
            For Each fsi In rootDirectory.GetFileSystemInfos()
                fshe.Add(New FileSystemHierarchyData(fsi))
            Next fsi
            Return fshe
        Else
            Throw New NotSupportedException( _
                "The FileSystemDataSource only " + _
                "presents data in an authenticated, localhost context.")
        End If
    End Function 'Select
End Class

Комментарии

ASP.NET поддерживает архитектуру привязки данных, которая позволяет серверным веб-элементам управления выполнять привязку к данным и представлять их единообразно. Веб-серверные элементы управления, привязанные к данным, называются элементами управления с привязкой к данным, а классы, упрощающие эту привязку, называются элементами управления источниками данных. Элементы управления источниками данных могут представлять любой источник данных: файл, поток, реляционную базу данных, бизнес-объект и т. д. Элементы управления источниками данных представляют данные единообразно для элементов управления, привязанных к данным, независимо от источника или формата базовых данных.

Элементы управления источниками данных, представляющие иерархические данные, являются производными от абстрактного HierarchicalDataSourceControl класса. Элемент управления источниками данных можно представить как сочетание объекта элемента управления источниками данных и связанных с ним представлений базовых данных, представленных объектами представления источников данных. Элементы управления иерархического источника данных поддерживают иерархическое представление источника данных для каждого иерархического уровня данных, которые они представляют. Представления источников данных не называются, как и DataSourceView объекты, связанные с DataSourceControl элементом управления, но идентифицируются по их уникальному иерархическому пути.

Представления источников данных определяют возможности элемента управления источниками данных. Все объекты представления источников данных, включая HierarchicalDataSourceView , поддерживают получение данных из базового источника данных с помощью Select метода, который извлекает иерархический список данных в виде IHierarchicalEnumerable объекта. Все объекты представления источников данных дополнительно поддерживают базовый набор возможностей, включая операции Insert ,, Update Delete и. Элемент управления, привязанный к данным, может обнаруживать возможности элемента управления источниками данных, получая связанное представление источника данных с помощью GetHierarchicalView метода и запрашивая представление во время разработки или во время выполнения. HierarchicalDataSourceView в настоящее время не Insert поддерживает Update Delete операции или.

Примечания для тех, кто реализует этот метод

При наследовании от класса HierarchicalDataSourceView необходимо переопределить следующий член: Select().

Конструкторы

HierarchicalDataSourceView()

Инициализирует новый экземпляр класса HierarchicalDataSourceView.

Методы

Equals(Object)

Определяет, равен ли указанный объект текущему объекту.

(Унаследовано от Object)
GetHashCode()

Служит хэш-функцией по умолчанию.

(Унаследовано от Object)
GetType()

Возвращает объект Type для текущего экземпляра.

(Унаследовано от Object)
MemberwiseClone()

Создает неполную копию текущего объекта Object.

(Унаследовано от Object)
Select()

Возвращает список всех элементов данных в представлении.

ToString()

Возвращает строку, представляющую текущий объект.

(Унаследовано от Object)

Применяется к

См. также раздел