LLBLGenProDataSource Class

General data source control which can be used in ASP.NET projects to perform design time databinding and runtime databinding.

Inheritance Hierarchy

SystemObject
  System.Web.UIControl
    System.Web.UIDataSourceControl
      SD.LLBLGen.Pro.ORMSupportClassesLLBLGenProDataSourceBase
        SD.LLBLGen.Pro.ORMSupportClassesLLBLGenProDataSource

Namespace: SD.LLBLGen.Pro.ORMSupportClasses
Assembly: SD.LLBLGen.Pro.ORMSupportClasses.Web (in SD.LLBLGen.Pro.ORMSupportClasses.Web.dll) Version: 5.0.0.0 (5.0.0)

Syntax

Copy

[DefaultEventAttribute("PerformSelect")]
[ToolboxBitmapAttribute(typeof(LLBLGenProDataSource), "ToolBoxImage.ico")]
[AspNetHostingPermissionAttribute(SecurityAction.LinkDemand, Level = AspNetHostingPermissionLevel.Minimal)]
[AspNetHostingPermissionAttribute(SecurityAction.InheritanceDemand, Level = AspNetHostingPermissionLevel.Minimal)]
public class LLBLGenProDataSource : LLBLGenProDataSourceBase

<DefaultEventAttribute("PerformSelect")>
<ToolboxBitmapAttribute(GetType(LLBLGenProDataSource), "ToolBoxImage.ico")>
<AspNetHostingPermissionAttribute(SecurityAction.LinkDemand, Level := AspNetHostingPermissionLevel.Minimal)>
<AspNetHostingPermissionAttribute(SecurityAction.InheritanceDemand, Level := AspNetHostingPermissionLevel.Minimal)>
Public Class LLBLGenProDataSource
	Inherits LLBLGenProDataSourceBase

The LLBLGenProDataSource type exposes the following members.

Constructors

	Name	Description
	LLBLGenProDataSource	Initializes a new instance of the LLBLGenProDataSource2 class.

Top

Properties

	Name	Description
	Adapter	Gets the browser-specific adapter for the control. (Inherited from Control.)
	AllFieldsKeepEmptyStringAsValue	Gets / sets the allFieldsKeepEmptyStringAsValue value. Setting this parameter to true will disable FieldNamesKeepEmptyStringAsValue. Default: false. (Inherited from LLBLGenProDataSourceBase.)
	AllowDuplicates	Gets or sets if the DataSourceControl should allow duplicate instances in the data retrieved. If DataContainerType is set to EntityCollection, this setting is ignored, as entitycollection fetches always filter out duplicates. (Inherited from LLBLGenProDataSourceBase.)
	AppRelativeTemplateSourceDirectory	Gets or sets the application-relative virtual directory of the Page or UserControl object that contains this control. (Inherited from Control.)
	ASPNetCacheDuration	Gets or sets the duration in minutes the state data is stored in the ASP.NET cache in between page postbacks. Only valid if CacheLocation is set to ASPNetCache. (Inherited from LLBLGenProDataSourceBase.)
	BindingContainer	Gets the control that contains this control's data binding. (Inherited from Control.)
	CacheLocation	Gets or sets the location where to store loaded data. Default is Viewstate. (Inherited from LLBLGenProDataSourceBase.)
	ChildControlsCreated	Gets a value that indicates whether the server control's child controls have been created. (Inherited from Control.)
	ClientID	Gets the server control identifier generated by ASP.NET. (Inherited from DataSourceControl.)
	ClientIDMode	This property is not used for data source controls. (Inherited from DataSourceControl.)
	ClientIDSeparator	Gets a character value representing the separator character used in the ClientID property. (Inherited from Control.)
	Context	Gets the HttpContext object associated with the server control for the current Web request. (Inherited from Control.)
	Controls	Gets a ControlCollection object that represents the child controls for a specified server control in the UI hierarchy. (Inherited from DataSourceControl.)
	DataContainerType	Gets or sets the type of the data container which contains the data inside this datasource control. (Inherited from LLBLGenProDataSourceBase.)
	DataItemContainer	Gets a reference to the naming container if the naming container implements IDataItemContainer. (Inherited from Control.)
	DataKeysContainer	Gets a reference to the naming container if the naming container implements IDataKeysControl. (Inherited from Control.)
	DesignMode	Gets a value indicating whether a control is being used on a design surface. (Inherited from Control.)
	EnablePaging	Gets or sets whether Paging is enabled on this control. Default is false. If you're using paging in a bound control, be sure to set this property to true so the LLBLGenProDataSourceControl will perform server-side paging instead of loading everything in memory and leave the paging to the bound control. (Inherited from LLBLGenProDataSourceBase.)
	EnableTheming	Gets a value indicating whether this control supports themes. (Inherited from DataSourceControl.)
	EnableViewState	Gets or sets a value indicating whether the server control persists its view state, and the view state of any child controls it contains, to the requesting client. (Inherited from Control.)
	EntityCollection	Gets or sets the entity collection contained in this object. Only valid if DataContainerType is set to EntityCollection.
	EntityCollectionTypeName	Gets or sets the name of the entity collection. Only valid if DataContainerType is set to EntityCollection
	Events	Gets a list of event handler delegates for the control. This property is read-only. (Inherited from Control.)
	FieldNamesKeepEmptyStringAsValue	Gets / sets the list of fieldnames for which "" is a valid value and which shouldn't be converted to null. (Inherited from LLBLGenProDataSourceBase.)
	FilterToUse	Gets or sets the filter to use.
	GroupBy	Gets or sets the GroupByCollection to use. Only valid if DataContainerType is set to TypedList or TypedView
	GroupByToUse	Gets or sets the GroupByCollection to use. Only valid if DataContainerType is set to TypedList or TypedView (Inherited from LLBLGenProDataSourceBase.)
	HasChildViewState	Gets a value indicating whether the current server control's child controls have any saved view-state settings. (Inherited from Control.)
	ID	Gets or sets the programmatic identifier assigned to the server control. (Inherited from Control.)
	IdSeparator	Gets the character used to separate control identifiers. (Inherited from Control.)
	IgnoreNullValuedSelectParameters	Gets or sets a value indicating whether select parameters which have the value null should be ignored (true) or not (false, default) (Inherited from LLBLGenProDataSourceBase.)
	InsertParameters	Parameters which are used to construct a PredicateExpression for live filtering. Hook up control properties or other parameters with the datasource so the datasource can filter based on values in other controls. (Inherited from LLBLGenProDataSourceBase.)
	IsChildControlStateCleared	Gets a value indicating whether controls contained within this control have control state. (Inherited from Control.)
	IsTrackingViewState	Gets a value that indicates whether the server control is saving changes to its view state. (Inherited from Control.)
	IsViewStateEnabled	Gets a value indicating whether view state is enabled for this control. (Inherited from Control.)
	LivePersistence	Gets or sets the value for LivePersistence, a flag which is used to determine whether fetches for data changes on the data (insert/update/delete) have to be propagated to the database directly (true) or have to be added to a UnitOfWork object (false). Default is true. (Inherited from LLBLGenProDataSourceBase.)
	LoadViewStateByID	Gets a value indicating whether the control participates in loading its view state by ID instead of index. (Inherited from Control.)
	MaxNumberOfItemsToReturn	Gets or sets the maximum number of items to return. Is ignored if EnablePaging is specified. (Inherited from LLBLGenProDataSourceBase.)
	NamingContainer	Gets a reference to the server control's naming container, which creates a unique namespace for differentiating between server controls with the same ID property value. (Inherited from Control.)
	Page	Gets a reference to the Page instance that contains the server control. (Inherited from Control.)
	Parent	Gets a reference to the server control's parent control in the page control hierarchy. (Inherited from Control.)
	PrefetchPathToUse	Gets or sets the PrefetchPath to use. Only valid if DataContainerType is set to EntityCollection
	Refetch	Gets / sets the flag whether the control should refetch the data at the next select call from the bound control(s). Set this flag to true when you've persisted the embedded UnitOfWork object. This will also clear the unitofwork object on the next select.
	RelationsToUse	Gets or sets the relations to use.
	RenderingCompatibility	Gets a value that specifies the ASP.NET version that rendered HTML will be compatible with. (Inherited from Control.)
	SelectParameters	Parameters which are used to construct a PredicateExpression for live filtering. Hook up control properties or other parameters with the datasource so the datasource can filter based on values in other controls. (Inherited from LLBLGenProDataSourceBase.)
	Site	Gets information about the container that hosts the current control when rendered on a design surface. (Inherited from Control.)
	SkinID	Gets the skin to apply to the DataSourceControl control. (Inherited from DataSourceControl.)
	SorterToUse	Gets or sets the SortExpression to use. (Inherited from LLBLGenProDataSourceBase.)
	SortingMode	Gets / sets the sortingmode. (Inherited from LLBLGenProDataSourceBase.)
	TemplateControl	Gets or sets a reference to the template that contains this control. (Inherited from Control.)
	TemplateSourceDirectory	Gets the virtual directory of the Page or UserControl that contains the current server control. (Inherited from Control.)
	ThrowExceptionOnIllegalFieldInput	Gets or sets the flag which signals this datasource control when setting fields to new values it should throw an exception if one or more field values in the input are illegal and can't be converted to the field's .NET type. (Inherited from LLBLGenProDataSourceBase.)
	TotalRowCount	Gets the total row count for the last query executed. Only valid if the query is a paging query and the datasource is ordered to obtain the total row count by the bound control. (Inherited from LLBLGenProDataSourceBase.)
	TypedList	Gets or sets the typed list contained in this object. Only valid if DataContainerType is set to TypedList.
	TypedListTypeName	Gets or sets the name of the typed list type. Only valid if DataContainerType is set to TypedList
	TypedView	Gets or sets the typed view contained in this object. Only valid if DataContainerType is set to TypedView.
	TypedViewTypeName	Gets or sets the name of the typed view type. Only valid if DataContainerType is set to TypedView
	UniqueID	Gets the unique, hierarchically qualified identifier for the server control. (Inherited from Control.)
	UnitOfWorkObject	Gets the UnitOfWork object used by this control. Not defined if LivePersistence is set to true.
	UpdateParameters	Parameters which are used to construct a PredicateExpression for live filtering. Hook up control properties or other parameters with the datasource so the datasource can filter based on values in other controls. (Inherited from LLBLGenProDataSourceBase.)
	ValidateRequestMode	Gets or sets a value that indicates whether the control checks client input from the browser for potentially dangerous values. (Inherited from Control.)
	ViewState	Gets a dictionary of state information that allows you to save and restore the view state of a server control across multiple requests for the same page. (Inherited from Control.)
	ViewStateIgnoresCase	Gets a value that indicates whether the StateBag object is case-insensitive. (Inherited from Control.)
	ViewStateMode	Gets or sets the view-state mode of this control. (Inherited from Control.)
	Visible	Gets or sets a value indicating whether the control is visually displayed. (Inherited from DataSourceControl.)

Top

Methods

	Name	Description
	AddedControl	Called after a child control is added to the Controls collection of the Control object. (Inherited from Control.)
	AddParsedSubObject	Notifies the server control that an element, either XML or HTML, was parsed, and adds the element to the server control's ControlCollection object. (Inherited from Control.)
	ApplyStyleSheetSkin	Applies the style properties that are defined in the page style sheet to the control. (Inherited from DataSourceControl.)
	BeginRenderTracing	Begins design-time tracing of rendering data. (Inherited from Control.)
	BuildProfileTree	Gathers information about the server control and delivers it to the Trace property to be displayed when tracing is enabled for the page. (Inherited from Control.)
	ClearCachedClientID	Sets the cached ClientID value to null. (Inherited from Control.)
	ClearChildControlState	Deletes the control-state information for the server control's child controls. (Inherited from Control.)
	ClearChildState	Deletes the view-state and control-state information for all the server control's child controls. (Inherited from Control.)
	ClearChildViewState	Deletes the view-state information for all the server control's child controls. (Inherited from Control.)
	ClearEffectiveClientIDMode	Sets the ClientIDMode property of the current control instance and of any child controls to Inherit. (Inherited from Control.)
	CreateChildControls	Called by the ASP.NET page framework to notify server controls that use composition-based implementation to create any child controls they contain in preparation for posting back or rendering. (Inherited from Control.)
	CreateControlCollection	Creates a collection to store child controls. (Inherited from DataSourceControl.)
	CreateStateDataObject	Creates the state data object. (Inherited from LLBLGenProDataSourceBase.)
	DataBind	Binds a data source to the invoked server control and all its child controls. (Inherited from Control.)
	DataBind(Boolean)	Binds a data source to the invoked server control and all its child controls with an option to raise the DataBinding event. (Inherited from Control.)
	DataBindChildren	Binds a data source to the server control's child controls. (Inherited from Control.)
	Dispose	Enables a server control to perform final clean up before it is released from memory. (Inherited from Control.)
	EndRenderTracing	Ends design-time tracing of rendering data. (Inherited from Control.)
	EnsureChildControls	Determines whether the server control contains child controls. If it does not, it creates child controls. (Inherited from Control.)
	EnsureID	Creates an identifier for controls that do not have an identifier assigned. (Inherited from Control.)
	Equals	Determines whether the specified object is equal to the current object. (Inherited from Object.)
	Finalize	Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Inherited from Object.)
	FindControl(String)	Searches the current naming container for a server control with the specified id parameter. (Inherited from DataSourceControl.)
	FindControl(String, Int32)	Searches the current naming container for a server control with the specified id and an integer, specified in the pathOffset parameter, which aids in the search. You should not override this version of the FindControl method. (Inherited from Control.)
	Focus	Sets input focus to the control. (Inherited from DataSourceControl.)
	GetDesignModeState	Gets design-time data for a control. (Inherited from Control.)
	GetHashCode	Serves as the default hash function. (Inherited from Object.)
	GetRouteUrl(Object)	Gets the URL that corresponds to a set of route parameters. (Inherited from Control.)
	GetRouteUrl(RouteValueDictionary)	Gets the URL that corresponds to a set of route parameters. (Inherited from Control.)
	GetRouteUrl(String, Object)	Gets the URL that corresponds to a set of route parameters and a route name. (Inherited from Control.)
	GetRouteUrl(String, RouteValueDictionary)	Gets the URL that corresponds to a set of route parameters and a route name. (Inherited from Control.)
	GetType	Gets the Type of the current instance. (Inherited from Object.)
	GetUniqueIDRelativeTo	Returns the prefixed portion of the UniqueID property of the specified control. (Inherited from Control.)
	GetView	Gets the view. (Overrides LLBLGenProDataSourceBaseGetView.)
	GetView(String)	Gets the named data source view associated with the data source control. (Inherited from LLBLGenProDataSourceBase.)
	GetViewNames	Gets a collection of names, representing the list of DataSourceView objects associated with the DataSourceControl control. (Inherited from LLBLGenProDataSourceBase.)
	HasControls	Determines if the server control contains any child controls. (Inherited from DataSourceControl.)
	HasEvents	Returns a value indicating whether events are registered for the control or any child controls. (Inherited from Control.)
	InitClass	Inits the class (Inherited from LLBLGenProDataSourceBase.)
	IsLiteralContent	Determines if the server control holds only literal content. (Inherited from Control.)
	LoadControlState	Restores control-state information from a previous page request that was saved by the SaveControlState method. (Inherited from LLBLGenProDataSourceBase.)
	LoadViewState	Restores view-state information from a previous page request that was saved by the SaveViewState method. (Inherited from LLBLGenProDataSourceBase.)
	MapPathSecure	Retrieves the physical path that a virtual path, either absolute or relative, maps to. (Inherited from Control.)
	MemberwiseClone	Creates a shallow copy of the current Object. (Inherited from Object.)
	OnBubbleEvent	Determines whether the event for the server control is passed up the page's UI server control hierarchy. (Inherited from Control.)
	OnDataBinding	Raises the DataBinding event. (Inherited from Control.)
	OnInit	Raises the Init event. (Inherited from LLBLGenProDataSourceBase.)
	OnLoad	Raises the Load event. (Inherited from Control.)
	OnPreRender	Raises the PreRender event. (Inherited from Control.)
	OnUnload	Raises the Unload event. (Inherited from Control.)
	OpenFile	Gets a Stream used to read a file. (Inherited from Control.)
	RaiseBubbleEvent	Assigns any sources of the event and its information to the control's parent. (Inherited from Control.)
	RaiseDataSourceChangedEvent	Raises the DataSourceChanged event. (Inherited from DataSourceControl.)
	RemovedControl	Called after a child control is removed from the Controls collection of the Control object. (Inherited from Control.)
	Render	Sends server control content to a provided HtmlTextWriter object, which writes the content to be rendered on the client. (Inherited from Control.)
	RenderChildren	Outputs the content of a server control's children to a provided HtmlTextWriter object, which writes the content to be rendered on the client. (Inherited from Control.)
	RenderControl(HtmlTextWriter)	Outputs server control content to a provided HtmlTextWriter object and stores tracing information about the control if tracing is enabled. (Inherited from DataSourceControl.)
	RenderControl(HtmlTextWriter, ControlAdapter)	Outputs server control content to a provided HtmlTextWriter object using a provided ControlAdapter object. (Inherited from Control.)
	ResolveAdapter	Gets the control adapter responsible for rendering the specified control. (Inherited from Control.)
	ResolveClientUrl	Gets a URL that can be used by the browser. (Inherited from Control.)
	ResolveUrl	Converts a URL into one that is usable on the requesting client. (Inherited from Control.)
	SaveControlState	Saves any server control state changes that have occurred since the time the page was posted back to the server. (Inherited from LLBLGenProDataSourceBase.)
	SaveViewState	Saves any server control view-state changes that have occurred since the time the page was posted back to the server. (Inherited from LLBLGenProDataSourceBase.)
	Select	Selects data from the underlying storage using the parameters set. You don't need to call this method if you've setup databinding using DataSourceID values. (Inherited from LLBLGenProDataSourceBase.)
	SetDesignModeState	Sets design-time data for a control. (Inherited from Control.)
	SetRenderMethodDelegate	Assigns an event handler delegate to render the server control and its content into its parent control. (Inherited from Control.)
	SetTraceData(Object, Object)	Sets trace data for design-time tracing of rendering data, using the trace data key and the trace data value. (Inherited from Control.)
	SetTraceData(Object, Object, Object)	Sets trace data for design-time tracing of rendering data, using the traced object, the trace data key, and the trace data value. (Inherited from Control.)
	ToString	Returns a string that represents the current object. (Inherited from Object.)
	TrackViewState	Causes tracking of view-state changes to the server control so they can be stored in the server control's StateBag object. This object is accessible through the ViewState property. (Inherited from LLBLGenProDataSourceBase.)

Top

Events

	Name	Description
	DataBinding	Occurs when the server control binds to a data source. (Inherited from Control.)
	Disposed	Occurs when a server control is released from memory, which is the last stage of the server control lifecycle when an ASP.NET page is requested. (Inherited from Control.)
	ElementsFetched	Event which is raised when LivePersistence is set to true and the datasource control has performed a fetch of elements (be it entities, a typed list or a typedview). Use this event to be able to perform actions when a fetch takes place. The sender of the event is the datasource control so use that object to obtain the data fetched. (Inherited from LLBLGenProDataSourceBase.)
	EntityDeleted	Event which is raised when LivePersistence is set to true and an entity was deleted successfully. The deleted entity is part of the event args. (Inherited from LLBLGenProDataSourceBase.)
	EntityDeleting	Event which is raised when this datasource control is about to perform the delete action on an entity. If LivePersistence is set to false, this event is raised right before the entity to delete is added to the unitofwork(2) object. Cancelling this event will abort the delete action and the entity won't be inserted. The entity to delete is part of the event args. (Inherited from LLBLGenProDataSourceBase.)
	EntityInserted	Event which is raised when LivePersistence is set to true and an entity was inserted successfully. The inserted entity is part of the event args. (Inherited from LLBLGenProDataSourceBase.)
	EntityInserting	Event which is raised when this datasource control is about to perform the Insert action on an entity. If LivePersistence is set to false, this event is raised right before the entity to insert is added to the unitofwork(2) object. Cancelling this event will abort the insert action and the entity won't be inserted. The entity to insert is part of the event args. (Inherited from LLBLGenProDataSourceBase.)
	EntityUpdated	Event which is raised when LivePersistence is set to true and an entity was updated successfully. The updated entity is part of the event args. (Inherited from LLBLGenProDataSourceBase.)
	EntityUpdating	Event which is raised when this datasource control is about to perform the update action on an entity. If LivePersistence is set to false, this event is raised right before the entity to update is added to the unitofwork(2) object. Cancelling this event will abort the update action and the entity won't be inserted. The entity to update is part of the event args. (Inherited from LLBLGenProDataSourceBase.)
	Init	Occurs when the server control is initialized, which is the first step in its lifecycle. (Inherited from Control.)
	Load	Occurs when the server control is loaded into the Page object. (Inherited from Control.)
	PerformGetDbCount	Event which is raised when LivePersistence is set to false and a GetDbCount has to be performed.
	PerformSelect	Event which is raised when LivePersistence is set to false and a select has to be performed.
	PerformWork	Event which is raised when LivePersistence is set to false and an insert/update/delete has to be performed.
	PreRender	Occurs after the Control object is loaded but prior to rendering. (Inherited from Control.)
	Unload	Occurs when the server control is unloaded from memory. (Inherited from Control.)

Top

Explicit Interface Implementations

	Name	Description
	IParserAccessorAddParsedSubObject	For a description of this member, see AddParsedSubObject(Object). (Inherited from Control.)
	IListSourceContainsListCollection	Indicates whether the data source control is associated with one or more lists of data. (Inherited from DataSourceControl.)
	IControlBuilderAccessorControlBuilder	For a description of this member, see ControlBuilder. (Inherited from Control.)
	IDataBindingsAccessorDataBindings	For a description of this member, see DataBindings. (Inherited from Control.)
	IDataSourceDataSourceChanged	Occurs when a data source control has changed in a way that affects data-bound controls. (Inherited from DataSourceControl.)
	IExpressionsAccessorExpressions	For a description of this member, see Expressions. (Inherited from Control.)
	IControlDesignerAccessorGetDesignModeState	For a description of this member, see GetDesignModeState. (Inherited from Control.)
	IListSourceGetList	Gets a list of data source controls that can be used as sources of lists of data. (Inherited from DataSourceControl.)
	IDataSourceGetView	Gets the named DataSourceView object associated with the DataSourceControl control. Some data source controls support only one view, while others support more than one. (Inherited from DataSourceControl.)
	IDataSourceGetViewNames	Gets a collection of names, representing the list of DataSourceView objects associated with the DataSourceControl control. (Inherited from DataSourceControl.)
	IDataBindingsAccessorHasDataBindings	For a description of this member, see HasDataBindings. (Inherited from Control.)
	IExpressionsAccessorHasExpressions	For a description of this member, see HasExpressions. (Inherited from Control.)
	IControlDesignerAccessorSetDesignModeState	For a description of this member, see SetDesignModeState(IDictionary). (Inherited from Control.)
	IControlDesignerAccessorSetOwnerControl	For a description of this member, see SetOwnerControl(Control). (Inherited from Control.)
	IControlDesignerAccessorUserData	For a description of this member, see UserData. (Inherited from Control.)

Top

Remarks

SelfServicing specific

Reference

SD.LLBLGen.Pro.ORMSupportClasses Namespace