Home Library Learn Downloads Support Community
Sign in | United States - English | |
This topic has not yet been rated - Rate this topic

UpdateableHierarchicalView Class

SharePoint 2010
System.Object
  System.Web.UI.HierarchicalDataSourceView
    Microsoft.SharePoint.WebControls.UpdateableHierarchicalView

Namespace:  Microsoft.SharePoint.WebControls
Assembly:  Microsoft.SharePoint (in Microsoft.SharePoint.dll)
Available in Sandboxed Solutions: No
C#
VB
Copy 
[AspNetHostingPermissionAttribute(SecurityAction.LinkDemand, Level = AspNetHostingPermissionLevel.Minimal)]
[AspNetHostingPermissionAttribute(SecurityAction.InheritanceDemand, Level = AspNetHostingPermissionLevel.Minimal)]
public abstract class UpdateableHierarchicalView : HierarchicalDataSourceView, 
	IDisposable
Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.
Did you find this helpful?
(1500 characters remaining)
Community Content Add
Annotations FAQ
UpdateableHierarchicalView
Description

The Microsoft.SharePoint.WebControls.UpdateableHierarchicalView class inherits from the System.IDisposable interface to accommodate object lifetime and the HierarchicalDataSourceView base class responsible for collecting data from a data source. UpdateableHierarchicalView provides a HierarchicalDataSourceView object that also incorporates an event handler to implement behavior for when the HierarchicalDataSourceView is changed, making it updateable. 

UpdateableHierarchicalView functions by providing the event handler EventUpdateableHierarchicalViewChanged in order to handle alterations to the object. 

The Usage Scenario

The primary usage of UpdateableHierarchicalView is internal, however within custom development it is common to use UpdateableHierarchicalView as a base class, overriding the data manipulation methods, namely Insert, Delete, Select, and Update. 

In the below the AdamHierarchicalDataSourceView class inherits from the UpdateableHierarchicalView class, and implements the minimal abstract inherited method member . Within each of the overrides, I am calling the UpdateableHierarchicalView.OnUpdateableHierarchicalViewChanged event, and just passing in EventArgs.Empty.

C# Code Example

public class AdamHierarchicalDataSourceView : UpdateableHierarchicalView
{
public override void Delete(System.Collections.Specialized.IOrderedDictionary values, System.Xml.XmlNamespaceManager manager)
{
OnUpdateableHierarchicalViewChanged(EventArgs.Empty);
}

public override void Insert(System.Collections.Specialized.IOrderedDictionary values, System.Xml.XmlNamespaceManager manager)
{
OnUpdateableHierarchicalViewChanged(EventArgs.Empty);
}

public override void Update(System.Collections.Specialized.IOrderedDictionary values, System.Xml.XmlNamespaceManager manager)
{
OnUpdateableHierarchicalViewChanged(EventArgs.Empty);
}

public override IHierarchicalEnumerable Select()
{
throw new NotImplementedException();
}
}

Visual Basic .NET Code Example

Public Class AdamHierarchicalDataSourceView
Inherits UpdateableHierarchicalView
Public Overloads Overrides Sub Delete(ByVal values As System.Collections.Specialized.IOrderedDictionary, ByVal manager As System.Xml.XmlNamespaceManager)
OnUpdateableHierarchicalViewChanged(EventArgs.Empty)
End Sub

Public Overloads Overrides Sub Insert(ByVal values As System.Collections.Specialized.IOrderedDictionary, ByVal manager As System.Xml.XmlNamespaceManager)
OnUpdateableHierarchicalViewChanged(EventArgs.Empty)
End Sub

Public Overloads Overrides Sub Update(ByVal values As System.Collections.Specialized.IOrderedDictionary, ByVal manager As System.Xml.XmlNamespaceManager)
OnUpdateableHierarchicalViewChanged(EventArgs.Empty)
End Sub

Public Overloads Overrides Function [Select]() As IHierarchicalEnumerable
Throw New NotImplementedException()
End Function
End Class

Adam Buenz
SharePoint Foundation MVP - http://www.sharepointsecurity.com
History