Class BaseGridRelatedAnyCollectionController<SI, T>

The base generic grid controller which works with the IBaseGridRelatedCollection<SI, T> view and displays an object type as rows in the grid that are all related to an other entity

This is the main base controller for creating grids, and dynamically creating their columns, for any object in the system that is related to another entity. It is different from BaseGridRelatedCollectionController<SI, T> as that only displays entities, and BaseGridControllerAny<T> as that can have multiple different types of parent it is related to where as this must be of type SI

Both this controller and the BaseDefaultSingleViewController<T> view have a similar mechanism for creating controls dynamically within the UI
Inheritance
System.Object
ModelViewController
BaseGridController
BaseGridControllerAny<T>
BaseGridRelatedAnyCollectionController<SI, T>
Inherited Members
System.Object.Equals(System.Object)
System.Object.Equals(System.Object, System.Object)
System.Object.GetHashCode()
System.Object.GetType()
System.Object.MemberwiseClone()
System.Object.ReferenceEquals(System.Object, System.Object)
System.Object.ToString()
Namespace: LemonEdge.Client.Core.Views.Core
Assembly: ClientCore.dll
Syntax
public abstract class BaseGridRelatedAnyCollectionController<SI, T> : BaseGridControllerAny<T>, IBaseGridController, IModelViewController, ICollectionExportable, INewGridItemImplementor<T>, ICopyGridItemImplementor<T>, IGrid, IDeleteGridItemImplementor<T> where SI : IBaseEntity
Type Parameters
Name Description
SI

An entity type inheriting from IBaseEntity
T

Any type that are all related to the SingleItem in the query

Constructors

BaseGridRelatedAnyCollectionController(IBaseGridRelatedCollection<SI, T>)

Creates a new BaseGridRelatedAnyCollectionController with the specified instance of a default grid related collection view

Declaration
public BaseGridRelatedAnyCollectionController(IBaseGridRelatedCollection<SI, T> view)
Parameters
Type Name Description
IBaseGridRelatedCollection<SI, T> view

The instance of the default grid related collection view in the client application

Properties

CollectionRelationshipColumnName

This is the property on the T entities that holds a relationship value that points to the SingleItem type

This controller will automatically use that to filter the correct entities for the grid in AlterQuery(QueryableExecuter<T>)

Declaration
public abstract string CollectionRelationshipColumnName { get; }
Property Value
Type Description
System.String

PopulateNewFromLookupColumnName

Returns OpenFromRelatedColumnName

Declaration
public override string PopulateNewFromLookupColumnName { get; }
Property Value
Type Description
System.String
Overrides
LemonEdge.Client.Core.Views.Core.BaseGridControllerAny<T>.PopulateNewFromLookupColumnName

SingleItem

The single item this grid is being displayed against and that all entities of type T in the grid are related to

Declaration
public SI SingleItem { get; }
Property Value
Type Description
SI

Methods

AddRelationshipJoin(QueryableExecuter<T>)

Alters the provided query by ensuring all entities returned are related to the SingleItem by having their CollectionRelationshipColumnName have the same value as the SingleItem ID

This can be overidden to customise how the entities of type T are precisely related to the SingleItem if not directly through that join

Declaration
protected virtual QueryableExecuter<T> AddRelationshipJoin(QueryableExecuter<T> query)
Parameters
Type Name Description
QueryableExecuter<T> query

The existing query to return all the results that will populate the grid
Returns
Type Description
QueryableExecuter<T>

An altered query that also ensures all entities returned are related to the SingleItem by having their CollectionRelationshipColumnName have the same value as the SingleItem ID

AlterQuery(QueryableExecuter<T>)

Additionally alters the base query alteration by ensuring all entities returned are related to the SingleItem by having their CollectionRelationshipColumnName have the same value as the SingleItem ID

This is achieved via AddRelationshipJoin(QueryableExecuter<T>) which can be overidden to customise how the entities of type T are precisely related to the SingleItem if not directly through that join

Declaration
protected override QueryableExecuter<T> AlterQuery(QueryableExecuter<T> query)
Parameters
Type Name Description
QueryableExecuter<T> query

The existing query to return all the results that will populate the grid
Returns
Type Description
QueryableExecuter<T>

An altered query that also ensures all entities returned are related to the SingleItem by having their CollectionRelationshipColumnName have the same value as the SingleItem ID
Overrides
LemonEdge.Client.Core.Views.Core.BaseGridControllerAny<T>.AlterQuery(LemonEdge.Utils.QueryableExecuter<T>)

GetGridController(IBaseGridRelatedCollection<SI, T>)

Creates the new default grid related view controller with the specified instance of a default grid related collection view

Either returns a BaseGridRelatedAnyCollectionController<SI, T> or a BaseGridRelatedCollectionController<SI, T>

Declaration
public static BaseGridControllerAny<T> GetGridController(IBaseGridRelatedCollection<SI, T> view)
Parameters
Type Name Description
IBaseGridRelatedCollection<SI, T> view

The instance of the default grid related colection view in the client application
Returns
Type Description
BaseGridControllerAny<T>

A new default grid view related controller with the specified instance of a default grid related controller view

UpdateNewItem(T)

Updates any new item created in this grid to also have the CollectionRelationshipColumnName property hold the value of the SingleItem ID

Declaration
protected override Task UpdateNewItem(T item)
Parameters
Type Name Description
T item

The new item created for this grid
Returns
Type Description
System.Threading.Tasks.Task

A task indicating the completion of the operation
Overrides
LemonEdge.Client.Core.Views.Core.BaseGridControllerAny<T>.UpdateNewItem(T)

Implements

Extension Methods