XmlHierarchicalDataSourceView.xml

<Type Name="XmlHierarchicalDataSourceView" FullName="System.Web.UI.WebControls.XmlHierarchicalDataSourceView">
  <TypeSignature Language="C#" Value="public class XmlHierarchicalDataSourceView : System.Web.UI.HierarchicalDataSourceView" />
  <TypeSignature Language="ILAsm" Value=".class public auto ansi beforefieldinit XmlHierarchicalDataSourceView extends System.Web.UI.HierarchicalDataSourceView" />
  <TypeSignature Language="DocId" Value="T:System.Web.UI.WebControls.XmlHierarchicalDataSourceView" />
  <TypeSignature Language="VB.NET" Value="Public Class XmlHierarchicalDataSourceView&#xA;Inherits HierarchicalDataSourceView" />
  <TypeSignature Language="F#" Value="type XmlHierarchicalDataSourceView = class&#xA;    inherit HierarchicalDataSourceView" />
  <TypeSignature Language="C++ CLI" Value="public ref class XmlHierarchicalDataSourceView : System::Web::UI::HierarchicalDataSourceView" />
  <AssemblyInfo>
    <AssemblyName>System.Web</AssemblyName>
    <AssemblyVersion>2.0.0.0</AssemblyVersion>
    <AssemblyVersion>4.0.0.0</AssemblyVersion>
  </AssemblyInfo>
  <Base>
    <BaseTypeName>System.Web.UI.HierarchicalDataSourceView</BaseTypeName>
  </Base>
  <Interfaces />
  <Docs>
    <summary>Represents a data view on an XML node or collection of XML nodes for an <see cref="T:System.Web.UI.WebControls.XmlDataSource" /> control.</summary>
    <remarks>
      <format type="text/markdown"><![CDATA[  
  
## Remarks  
 The <xref:System.Web.UI.WebControls.XmlDataSource> control can present its underlying data in both tabular and hierarchical format to Web server controls that bind to it. Controls such as <xref:System.Web.UI.WebControls.GridView> or <xref:System.Web.UI.WebControls.DropDownList> use the <xref:System.Web.UI.WebControls.XmlDataSource> to bind to XML data and present it in list or tabular form, while controls that derive from the <xref:System.Web.UI.WebControls.HierarchicalDataBoundControl> class, such as <xref:System.Web.UI.WebControls.TreeView>, bind to XML data and present it in hierarchical form.  
  
 The <xref:System.Web.UI.WebControls.XmlDataSource> creates each view type internally through different code paths. If the <xref:System.Web.UI.IDataSource.GetView%2A> method is called on the <xref:System.Web.UI.WebControls.XmlDataSource> control, an <xref:System.Web.UI.WebControls.XmlDataSourceView> object is created by the <xref:System.Web.UI.WebControls.XmlDataSource> control. If the <xref:System.Web.UI.WebControls.XmlDataSource.GetHierarchicalView%2A> method is called, an <xref:System.Web.UI.WebControls.XmlHierarchicalDataSourceView> object is created. The <xref:System.Web.UI.WebControls.XmlDataSourceView> class is provided for Web server controls that derive from <xref:System.Web.UI.WebControls.DataBoundControl> and bind to lists and tabular data, while the <xref:System.Web.UI.WebControls.XmlHierarchicalDataSourceView> is provided for Web server controls that derive from <xref:System.Web.UI.WebControls.HierarchicalDataBoundControl> and bind to hierarchical data. Internally, the <xref:System.Web.UI.WebControls.DataBoundControl> and <xref:System.Web.UI.WebControls.CompositeDataBoundControl> classes call the <xref:System.Web.UI.WebControls.XmlDataSourceView.Select%2A> method of <xref:System.Web.UI.WebControls.XmlDataSourceView> object view to retrieve data from a data source, while a class derived from <xref:System.Web.UI.WebControls.HierarchicalDataBoundControl> calls the <xref:System.Web.UI.WebControls.XmlHierarchicalDataSourceView.Select%2A> method.  
  
 Like all <xref:System.Web.UI.HierarchicalDataSourceView> helper objects, the <xref:System.Web.UI.WebControls.XmlHierarchicalDataSourceView> defines the operations that the data source can perform with the underlying data. Because the <xref:System.Web.UI.WebControls.XmlHierarchicalDataSourceView> class only overrides the <xref:System.Web.UI.WebControls.XmlHierarchicalDataSourceView.Select%2A> method, the associated <xref:System.Web.UI.WebControls.XmlDataSource> control does not support sort expressions or execute, delete, or update operations.  
  
 ]]></format>
    </remarks>
    <altmember cref="T:System.Web.UI.HierarchicalDataSourceView" />
    <altmember cref="T:System.Web.UI.DataSourceView" />
  </Docs>
  <Members>
    <Member MemberName="Select">
      <MemberSignature Language="C#" Value="public override System.Web.UI.IHierarchicalEnumerable Select ();" />
      <MemberSignature Language="ILAsm" Value=".method public hidebysig virtual instance class System.Web.UI.IHierarchicalEnumerable Select() cil managed" />
      <MemberSignature Language="DocId" Value="M:System.Web.UI.WebControls.XmlHierarchicalDataSourceView.Select" />
      <MemberSignature Language="VB.NET" Value="Public Overrides Function Select () As IHierarchicalEnumerable" />
      <MemberSignature Language="F#" Value="override this.Select : unit -&gt; System.Web.UI.IHierarchicalEnumerable" Usage="xmlHierarchicalDataSourceView.Select " />
      <MemberSignature Language="C++ CLI" Value="public:&#xA; override System::Web::UI::IHierarchicalEnumerable ^ Select();" />
      <MemberType>Method</MemberType>
      <AssemblyInfo>
        <AssemblyName>System.Web</AssemblyName>
        <AssemblyVersion>2.0.0.0</AssemblyVersion>
        <AssemblyVersion>4.0.0.0</AssemblyVersion>
      </AssemblyInfo>
      <ReturnValue>
        <ReturnType>System.Web.UI.IHierarchicalEnumerable</ReturnType>
      </ReturnValue>
      <Parameters />
      <Docs>
        <summary>Gets a list of the data items from the underlying data source.</summary>
        <returns>An <see cref="T:System.Web.UI.IHierarchicalEnumerable" /> collection of data items based on the hierarchical level of the current view.</returns>
        <remarks>
          <format type="text/markdown"><![CDATA[  
  
## Remarks  
 The <xref:System.Web.UI.IHierarchicalEnumerable> that is returned by <xref:System.Web.UI.HierarchicalDataSourceView.Select%2A> is an <xref:System.Xml.XmlNodeList> and can be used like any <xref:System.Collections.IEnumerable> collection. Call the <xref:System.Collections.IEnumerable.GetEnumerator%2A> method to get an <xref:System.Collections.IEnumerator> and iterate through the collection of <xref:System.Xml.XmlNode> nodes, or use `foreach` (in C#) or `For Each` (Visual Basic).  
  
 ]]></format>
        </remarks>
        <altmember cref="Overload:System.Web.UI.WebControls.XmlDataSourceView.Select" />
      </Docs>
    </Member>
  </Members>
</Type>