Intersoft WebGrid Documentation
Hierarchical Property
See Also  Send Feedback
ISNet.WebUI.WebGrid Namespace > LayoutSet Class : Hierarchical Property






Specifies whether or not WebGrid will display hierarchical data.

Syntax

Visual Basic (Declaration) 
<ISNet.Serialization.BinarySerializableAttribute()>
<ISNet.PersistLayoutAttribute(False)>
<ISNet.Serialization.XmlSerializableAttribute()>
<DescriptionAttribute("Specifies whether or not WebGrid will display hierarchical data.")>
<NotifyParentPropertyAttribute(True)>
<DefaultValueAttribute()>
Public Property Hierarchical As Boolean
Visual Basic (Usage)Copy Code
Dim instance As LayoutSet
Dim value As Boolean
 
instance.Hierarchical = value
 
value = instance.Hierarchical
C# 
[ISNet.Serialization.BinarySerializableAttribute()]
[ISNet.PersistLayoutAttribute(false)]
[ISNet.Serialization.XmlSerializableAttribute()]
[DescriptionAttribute("Specifies whether or not WebGrid will display hierarchical data.")]
[NotifyParentPropertyAttribute(true)]
[DefaultValueAttribute()]
public bool Hierarchical {get; set;}
Delphi 
public read-write property Hierarchical: Boolean; 
JScript 
ISNet.Serialization.BinarySerializableAttribute()
ISNet.PersistLayoutAttribute()
ISNet.Serialization.XmlSerializableAttribute()
DescriptionAttribute("Specifies whether or not WebGrid will display hierarchical data.")
NotifyParentPropertyAttribute()
DefaultValueAttribute()
public function get,set Hierarchical : boolean
Managed Extensions for C++ 
[ISNet.Serialization.BinarySerializableAttribute()]
[ISNet.PersistLayoutAttribute(false)]
[ISNet.Serialization.XmlSerializableAttribute()]
[DescriptionAttribute("Specifies whether or not WebGrid will display hierarchical data.")]
[NotifyParentPropertyAttribute(true)]
[DefaultValueAttribute()]
public: __property bool get_Hierarchical();
public: __property void set_Hierarchical( 
   bool value
);
C++/CLI 
[ISNet.Serialization.BinarySerializableAttribute()]
[ISNet.PersistLayoutAttribute(false)]
[ISNet.Serialization.XmlSerializableAttribute()]
[DescriptionAttribute("Specifies whether or not WebGrid will display hierarchical data.")]
[NotifyParentPropertyAttribute(true)]
[DefaultValueAttribute()]
public:
property bool Hierarchical {
   bool get();
   void set (    bool value);
}

Remarks

Sets the Hierarchical to True, to display hierarchical data from your DataSource. WebGrid has been simplified so that you only need to change this property to switch between Flat or Hierarchical data display. When set to True, WebGrid will automatically renders the Hierarchical elements and automatically load the data source when needed.

WebGrid's Hierarchical feature is built with performance, efficiency and scalability as its key design. On first time the page load, only RootTable DataSource is processed. When users click on [+] (expand) sign which is an icon representation in left most of a record, the control will automatically and transparently load the childTable's contents. This enables a superior performance when interact with information and large datasets.

For much greater control of loading childTable's dataSource, WebGrid provides InitializeChildTableDataSource event, allow you to control the data retrieval codes by using the given parentConstraints parameter. This enables the use of WebGrid in large enterprise web applications such as call center, CRM or ERP.

There are two types of hierarchical select operation supported in WebGrid.NET Enterprise 5.0 such as discussed in the following :

  1. Load all child tables data source (default)
    By default, all tables defined in the dataset that connected to the datasource control will be loaded at first page request. For instance, a dataset containing hierarchical tables such as Customers => Orders => Order Details will have all three tables loaded. This default scenario is best used to display relatively small amount of hierarchical data.
  2. Load child tables data source on demand
    Data binding and on demand data retrieval concept has significantly changed in WebGrid.NET Enterprise 5.0 along with the new datasource control support. In previous versions, WebGrid is serving as both User Interface and Data Access component. By being Data Access component, it means WebGrid also handles the datasource level functions such as initializing the datasource and performing on demand function on Grid level through events.
    WebGrid is now serving as pure User Interface since WebGrid is supported by datasource control. That means WebGrid no longer handle datasource level manipulation. Instead, WebGrid simply connects to a datasource control which primarily performing data retrieval and data manipulation. With this new concept, WebGrid simply displays a valid datasource that has been successfully retrieved by datasource control.

Note that you can still enable Hierarchical Grid to be used together with Column Freezing feature, although the Column Freezing is designed for flat-view Grid. When Hierarchical is enabled along with Column Freezing feature, horizontal scrolling affects to RootTable view only. The child table will not be scrolled.

Unbound Hierarchical

WebGrid.NET Enterprise 5.0 allows you to configure Hierarchical child tables in Unbound mode. In previous versions, WebGrid only support databound mode to be used in Hierarchical feature. To simulate Unbound mode in previous versions, you usually create a temporary DataSet and the DataTables and map them through DataRelation.

In version 5.0, you no longer need temporary DataSet or workaround in order to configure hierarchical Grid in Unbound mode. WebGrid 5.0 supports pure Unbound mode through server side object model.
For more information, please read Walkthrough: Create Unbound WebGrid with Hierarchical enabled.

Requirements

Target Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family, Windows Vista, Windows Server 2008 family

See Also

©2012 Intersoft Solutions Corp. All Rights Reserved.