Click or drag to resize
DataQuerySettingsBaseTQuery Class
Defines parameters for the data selection
Inheritance Hierarchy
SystemObject
  CMS.DataEngineAbstractQueryObject
    CMS.DataEngineQueryParametersBaseTQuery
      CMS.DataEngineWhereConditionBaseTQuery
        CMS.DataEngineDataQuerySettingsBaseTQuery
          CMS.DataEngineDataQueryBaseTQuery
          CMS.DataEngineDataQuerySettings

Namespace: CMS.DataEngine
Assembly: CMS.DataEngine (in CMS.DataEngine.dll) Version: 13.0.131
Syntax
C#
public abstract class DataQuerySettingsBase<TQuery> : WhereConditionBase<TQuery>, 
	IDataQuerySettings<TQuery>, IWhereCondition<TQuery>, IWhereCondition, IQueryParameters, 
	IQueryObject, IQueryParameters<TQuery>, IDataQuerySettings
where TQuery : new(), DataQuerySettingsBase<TQuery>

Type Parameters

TQuery

The DataQuerySettingsBaseTQuery type exposes the following members.

Constructors
Fields
Properties
  NameDescription
Public propertyDataSourceName
Data source identifier that represents the location from which the data are obtained.
(Inherited from WhereConditionBaseTParent.)
Public propertyDefaultQuerySource
Default source of the query in case source is not defined
Public propertyFilterColumns
List of columns used for extra filtering within the query, e.g. "CMS_C, CMS_RN"
Protected propertyForceOrderBy
If true, the order by should be forced in the process of execution
Public propertyGroupByColumns
List of columns to group by, by default doesn't group, e.g. "NodeLevel, NodeOwner"
Public propertyHasGroupBy
Returns true if the given query has group by set
Public propertyHavingCondition
Where condition for the group by on the data, e.g. "DocumentName = 'ABC'"
Public propertyHavingIsComplex
Returns true if the given having condition is a complex condition
Public propertyHavingIsEmpty
Returns true if the having condition is empty
Protected propertyIsImmutable
If true, this object instance is immutable, and next subsequent modification starts with a clone of the object.
(Inherited from QueryParametersBaseTParent.)
Public propertyIsNested
Indicates that this query is nested within another query as its source. This brings certain constraints such as that is cannot use CTE.
Public propertyIsPagedQuery
Returns true if the query has the paging enabled
Public propertyIsSubQuery
If true, the query is a sub-query used in another query. This brings certain constraints such as that it cannot use order by or CTE.
Public propertyMaxRecords
Maximum number of results to return (use for paging together with Offset)
Public propertyName
Object name, empty by default
(Inherited from AbstractQueryObject.)
Public propertyOffset
Index of the first record to return (use for paging together with MaxRecords)
Public propertyOrderByColumns
List of columns by which the result should be sorted, e.g. "NodeLevel, DocumentName DESC"
Public propertyParameters
Query data parameters
(Inherited from QueryParametersBaseTParent.)
Public propertyQuerySource
Query source object
Public propertyReturnsNoResults
Returns true if query doesn't return any results
(Inherited from WhereConditionBaseTParent.)
Public propertySelectColumnsList
List of columns to return, by default returns all columns, e.g. "DocumentName, DocumentID"
Public propertySelectDistinct
If set to true, returns only distinct (different) values.
Public propertyTopNRecords
If set, selects only first top N number of records
Public propertyTotalExpression
Total items expression. When defined, used instead default total items for a paged query.
Protected propertyWhereBuilder
Where condition builder
(Inherited from WhereConditionBaseTParent.)
Public propertyWhereCondition
Where condition on the data, e.g. "DocumentName = 'ABC'"
(Inherited from WhereConditionBaseTParent.)
Public propertyWhereIsComplex
Returns true if the given where condition contains compound conditions, e. g. "A > 1 AND B = 5"
(Inherited from WhereConditionBaseTParent.)
Public propertyWhereIsEmpty
Returns true if the where condition is empty
(Inherited from WhereConditionBaseTParent.)
Protected propertyWhereOperator
Operator used for adding where condition. Default is AND
(Inherited from WhereConditionBaseTParent.)
Top
Methods
  NameDescription
Public methodAddColumn(String)
Adds the additional column to the query
Public methodAddColumn(IQueryColumn)
Adds the additional column to the query
Public methodAddColumns(IEnumerableString)
Adds the additional columns to the query
Public methodAddColumns(String)
Adds the additional columns to the query
Public methodAddColumns(IQueryColumn)
Adds the additional columns to the query
Public methodAddFilterColumn
Adds the additional filter column to the query
Protected methodAddHavingInternal
Adds the given having condition
Protected methodAddWhereCondition
Adds the given where condition to the final where condition
(Inherited from WhereConditionBaseTParent.)
Protected methodAddWhereConditionInternal
Adds the given where condition
(Inherited from WhereConditionBaseTParent.)
Public methodAnd
Changes the where operator to AND for subsequent where conditions. Use in combination of methods Where...
(Inherited from WhereConditionBaseTParent.)
Public methodAnd(IWhereCondition)
Adds the given where condition with the AND operator
(Inherited from WhereConditionBaseTParent.)
Public methodAnd(ActionWhereCondition)
Adds the given where condition with the AND operator. Creates a new where condition object and runs the setup actions on it.
(Inherited from WhereConditionBaseTParent.)
Protected methodAnySettingsDefined
Returns true if the object has any settings defined that influence the resulting query
(Overrides WhereConditionBaseTParentAnySettingsDefined.)
Public methodApplyParametersTo
Applies this query parameters to the target object
(Overrides WhereConditionBaseTParentApplyParametersTo(IQueryObject).)
Public methodChanged
Marks the object as changed
(Inherited from AbstractQueryObject.)
Protected methodCheckReturnsNoResults
Checks if where condition results in no data
(Inherited from WhereConditionBaseTParent.)
Public methodClone
Creates the clone of the object.
(Inherited from QueryParametersBaseTParent.)
Public methodCloneObject
Creates the clone of the object.
(Inherited from QueryParametersBaseTParent.)
Public methodColumn(String)
Sets the column to select
Public methodColumn(IQueryColumn)
Sets the column to select
Public methodColumns(IEnumerableString)
Sets the columns to select
Public methodColumns(String)
Sets the columns to select
Public methodColumns(IQueryColumn)
Sets the columns to select
Public methodCopyPropertiesTo
Creates the clone of the collection.
(Overrides WhereConditionBaseTParentCopyPropertiesTo(IQueryObject).)
Public methodDistinct
Sets the query to use distinct selection over the given columns
Public methodEnsureParameters
Ensures data parameters for the given query
(Inherited from QueryParametersBaseTParent.)
Public methodEquals(Object)
Determines whether the specified Object is equal to the current Object.
(Inherited from WhereConditionBaseTParent.)
Public methodExpand
Expands the expression by replacing parameters with their values
(Inherited from QueryParametersBaseTParent.)
Protected methodGetDataSourceName
Gets data source identifier that represents the location from which the data are obtained.
(Inherited from WhereConditionBaseTParent.)
Protected methodGetDefaultSource
Gets the default source for this query
Public methodGetExpressions
Gets the query expressions
Public methodGetHashCode
Serves as a hash function for a particular type.
(Inherited from WhereConditionBaseTParent.)
Public methodGetTypedQuery
Returns specifically typed instance of current Query object to allow user to compose Query in fluent syntax. If current Query is immutable then its clone is returned.
(Inherited from QueryParametersBaseTParent.)
Protected methodGetWhere(String, QueryOperator, Object)
Gets the where condition for the given column
(Inherited from WhereConditionBaseTParent.)
Protected methodGetWhere(IQueryObjectWithValue, QueryOperator, Object)
Gets the where condition for the given column
(Inherited from WhereConditionBaseTParent.)
Public methodGroupBy
Specifies the columns to group by
Public methodHasCompatibleSource
Returns true if the given query is an external source
(Inherited from WhereConditionBaseTParent.)
Public methodHaving(IWhereCondition)
Adds the given having conditions to the query.
Public methodHaving(ActionWhereCondition)
Adds the given where condition to the query. Creates a new where condition object and runs the setup actions on it.
Public methodHaving(String, Boolean)
Specifies the having condition
Public methodImmutable
Makes this object instance immutable, and next subsequent modification starts with a clone of the object.
(Inherited from QueryParametersBaseTParent.)
Public methodIncludeDataParameters
Adds the data parameters to the current query parameters
(Inherited from QueryParametersBaseTParent.)
Public methodNewGroupBy
Clears the current group by, reverting the source of data to the original. Note, that this method also resets the existing having condition which is closely bound to the group by.
Public methodNewHaving
Clears the current having condition
Public methodNewWhere
Clears the current where condition
(Inherited from WhereConditionBaseTParent.)
Public methodNextPage
Adjusts the query to a next page, using the current page size. Use in combination with PagedBy and NextPageAvailable to iterate over the data in batches.
Protected methodNoColumns
Sets the query to return no columns at all
Public methodNoResults
Sets the where condition to exclude all data from result
(Inherited from WhereConditionBaseTParent.)
Public methodNotPaged
Sets up the query to become not paged query and output all results at once.
Public methodOr
Changes the where operator to OR for next where conditions. Use in combination of methods Where...
(Inherited from WhereConditionBaseTParent.)
Public methodOr(IWhereCondition)
Adds the given where condition with the OR operator
(Inherited from WhereConditionBaseTParent.)
Public methodOr(ActionWhereCondition)
Adds the given where condition with the OR operator. Creates a new where condition object and runs the setup actions on it.
(Inherited from WhereConditionBaseTParent.)
Public methodOrderBy(String)
Adds the columns to the order by query
Public methodOrderBy(OrderDirection, String)
Adds the columns to the order by query
Public methodOrderByAscending
Adds the columns to the order by query to order by the given columns in ascending order
Public methodOrderByDescending
Adds the columns to the order by query to order by the given columns in descending order
Public methodPage
Specifies the page to select with given page index and page size. Page number is indexed from 0 (first page)
Public methodPagedBy
Sets up the query as a paged query with the given page size. Resets the page index to first page. Use in combination with NextPageAvailable and NextPage to iterate over the data in batches.
Public methodReplaceColumn
Replaces the selected column with a new name
Protected methodReplaceOrderByColumn
Replaces the selected column with a new name
Protected methodReplaceSelectedColumn
Replaces the selected column with a new name
Public methodReset
Flushes the results but leaves the generated query text unchanged. After the reset, query can be executed again to obtain new data.
(Inherited from AbstractQueryObject.)
Protected methodResetWhereOperator
Resets the where operator to the default value
(Inherited from WhereConditionBaseTParent.)
Public methodReturnNoResults
Sets the query to return no results. This action is irreversible, once the query is set to return no results it cannot be changed. This method is used by data engine to forbid access to data that are not allowed to be accessed (e.g. license limitations), without notifying the process about the fact.
(Inherited from WhereConditionBaseTParent.)
Public methodSnapshot Obsolete.
Creates an immutable snapshot of the current query as a base for further evaluation. Doesn't modify the original query in any way.
(Inherited from QueryParametersBaseTParent.)
Public methodTake
Identity method to make the query expression more readable. Use before the Columns or Page method. Doesn't provide any functionality.
Public methodThen
Identity method to make the query expression more readable. Use before the OrderBy method. Doesn't provide any functionality.
Public methodTopN
Selects only first top N number of records
Public methodToString
Returns the string representation of the expression
(Inherited from QueryParametersBaseTParent.)
Public methodToString(Boolean)
Returns the string representation of the expression, with possibility of expanding parameters
(Overrides WhereConditionBaseTParentToString(Boolean).)
Public methodWhere(IWhereCondition)
Adds the given where conditions to the query
(Inherited from WhereConditionBaseTParent.)
Public methodWhere(ActionWhereCondition)
Adds the given where condition to the query. Creates a new where condition object and runs the setup actions on it.
(Inherited from WhereConditionBaseTParent.)
Public methodWhere(String, QueryDataParameters)
Adds the given where condition to the query
(Inherited from WhereConditionBaseTParent.)
Public methodWhere(String, QueryUnaryOperator)
Adds the given where condition to the query. Matches the column value with an unary operator.
(Inherited from WhereConditionBaseTParent.)
Public methodWhere(IQueryObjectWithValue, QueryUnaryOperator)
Adds the given where condition to the query. Matches the column value with an unary operator.
(Inherited from WhereConditionBaseTParent.)
Public methodWhere(String, QueryOperator, Object)
Adds the given where condition to the query. Matches the column to a given value.
(Inherited from WhereConditionBaseTParent.)
Public methodWhere(IQueryObjectWithValue, QueryOperator, Object)
Adds the given where condition to the query. Matches the column to a given value.
(Inherited from WhereConditionBaseTParent.)
Public methodWhereContains(String, String)
Adds the condition for a string column to contain some substring
(Inherited from WhereConditionBaseTParent.)
Public methodWhereContains(IQueryObjectWithValue, String)
Adds the condition for a string column to contain some substring
(Inherited from WhereConditionBaseTParent.)
Public methodWhereEmpty
Adds the where condition for a null or empty column value
(Inherited from WhereConditionBaseTParent.)
Public methodWhereEndsWith(String, String)
Adds the condition for a string column to end with some prefix
(Inherited from WhereConditionBaseTParent.)
Public methodWhereEndsWith(IQueryObjectWithValue, String)
Adds the condition for a string expression to end with some prefix
(Inherited from WhereConditionBaseTParent.)
Public methodWhereEquals(String, Object)
Adds the given where condition to the query. Matches the column to a given value.
(Inherited from WhereConditionBaseTParent.)
Public methodWhereEquals(IQueryObjectWithValue, Object)
Adds the given where condition to the query. Matches the left side to the given right side.
(Inherited from WhereConditionBaseTParent.)
Public methodWhereEqualsOrNull
Adds the given where condition to the query. Matches the column to a given value or null value.
(Inherited from WhereConditionBaseTParent.)
Public methodWhereExists(IDataQuery)
Adds where condition with EXISTS and the nested query "EXISTS (...)"
(Inherited from WhereConditionBaseTParent.)
Protected methodWhereExists(IDataQuery, Boolean)
Adds where condition with EXISTS and the nested query "EXISTS (...)"
(Inherited from WhereConditionBaseTParent.)
Public methodWhereFalse(String)
Adds the where condition for a false column value (boolean column equals false).
(Inherited from WhereConditionBaseTParent.)
Public methodWhereFalse(IQueryObjectWithValue)
Adds the where condition for a false expression value (boolean expression equals false).
(Inherited from WhereConditionBaseTParent.)
Public methodWhereGreaterOrEquals(String, Object)
Adds the given where condition to the query. Matches the left side which is greater or equal than the right side.
(Inherited from WhereConditionBaseTParent.)
Public methodWhereGreaterOrEquals(IQueryObjectWithValue, Object)
Adds the given where condition to the query. Matches the left side which is greater or equal than the right side.
(Inherited from WhereConditionBaseTParent.)
Public methodWhereGreaterThan(String, Object)
Adds the given where condition to the query. Matches the left side which is greater than the right side.
(Inherited from WhereConditionBaseTParent.)
Public methodWhereGreaterThan(IQueryObjectWithValue, Object)
Adds the given where condition to the query. Matches the left side which is greater than the right side.
(Inherited from WhereConditionBaseTParent.)
Public methodWhereID
Adds the where condition to match the ID to the query. In case the column name is not provided or unknown, does not generate where condition. If given ID is invalid, adds the condition to match NULL.
(Inherited from WhereConditionBaseTParent.)
Public methodWhereIn(String, IDataQuery)
Adds where condition to the nested query, e.g. "columnName IN (...)"
(Inherited from WhereConditionBaseTParent.)
Public methodWhereIn(String, ICollectionInt32)
Adds where condition to the list of values, e.g. "columnName IN (...)"
(Inherited from WhereConditionBaseTParent.)
Protected methodWhereIn(String, IDataQuery, Boolean)
Adds where condition to the list of values, e.g. "columnName IN (...)". Supported generic type is int, long, string or guid ONLY!
(Inherited from WhereConditionBaseTParent.)
Protected methodWhereIn(String, ICollectionInt32, Boolean)
Adds where condition to the list of values, e.g. "columnName IN (...)"
(Inherited from WhereConditionBaseTParent.)
Public methodWhereLessOrEquals(String, Object)
Adds the given where condition to the query. Matches the left side which is less or equal than the right side.
(Inherited from WhereConditionBaseTParent.)
Public methodWhereLessOrEquals(IQueryObjectWithValue, Object)
Adds the given where condition to the query. Matches the left side which is less or equal than the right side.
(Inherited from WhereConditionBaseTParent.)
Public methodWhereLessThan(String, Object)
Adds the given where condition to the query. Matches the left side which is less than the right side.
(Inherited from WhereConditionBaseTParent.)
Public methodWhereLessThan(IQueryObjectWithValue, Object)
Adds the given where condition to the query. Matches the left side which is less than the right side.
(Inherited from WhereConditionBaseTParent.)
Public methodWhereLike(String, String)
Adds the given where condition to the query. Matches the column to a given value using LIKE operator.
(Inherited from WhereConditionBaseTParent.)
Public methodWhereLike(IQueryObjectWithValue, Object)
Adds the given where condition to the query. Matches the left side and right side using LIKE operator.
(Inherited from WhereConditionBaseTParent.)
Public methodWhereNot
Adds the negation of the given where condition
(Inherited from WhereConditionBaseTParent.)
Public methodWhereNotContains(String, String)
Adds the condition for a string column not to contain some substring
(Inherited from WhereConditionBaseTParent.)
Public methodWhereNotContains(IQueryObjectWithValue, String)
Adds the condition for a string column not to contain some substring
(Inherited from WhereConditionBaseTParent.)
Public methodWhereNotEmpty
Adds the where condition for a non empty column value
(Inherited from WhereConditionBaseTParent.)
Public methodWhereNotEndsWith(String, String)
Adds the condition for a string column not to end with some prefix
(Inherited from WhereConditionBaseTParent.)
Public methodWhereNotEndsWith(IQueryObjectWithValue, String)
Adds the condition for a string column not to end with some prefix
(Inherited from WhereConditionBaseTParent.)
Public methodWhereNotEquals(String, Object)
Adds the given where condition to the query. Matches the column which is not equal to a given value.
(Inherited from WhereConditionBaseTParent.)
Public methodWhereNotEquals(IQueryObjectWithValue, Object)
Adds the given where condition to the query. Matches the left side which is not equal to the right side.
(Inherited from WhereConditionBaseTParent.)
Public methodWhereNotExists
Adds where condition with NOT EXISTS and the nested query "NOT EXISTS (...)"
(Inherited from WhereConditionBaseTParent.)
Public methodWhereNotIn(String, IDataQuery)
Adds where condition to the nested query, e.g. "columnName NOT IN (...)"
(Inherited from WhereConditionBaseTParent.)
Public methodWhereNotIn(String, ICollectionInt32)
Adds where condition to the list of values, e.g. "columnName NOT IN (...)"
(Inherited from WhereConditionBaseTParent.)
Public methodWhereNotLike(String, String)
Adds the given where condition to the query. Matches the column to a given value using NOT LIKE operator.
(Inherited from WhereConditionBaseTParent.)
Public methodWhereNotLike(IQueryObjectWithValue, Object)
Adds the given where condition to the query. Matches the left side and right side using NOT LIKE operator.
(Inherited from WhereConditionBaseTParent.)
Public methodWhereNotNull(String)
Adds the where condition for a not null column value
(Inherited from WhereConditionBaseTParent.)
Public methodWhereNotNull(IQueryObjectWithValue)
Adds the where condition for a not null expression value
(Inherited from WhereConditionBaseTParent.)
Public methodWhereNotStartsWith(String, String)
Adds the condition for a string column not to start with some prefix
(Inherited from WhereConditionBaseTParent.)
Public methodWhereNotStartsWith(IQueryObjectWithValue, String)
Adds the condition for a string column not to start with some prefix
(Inherited from WhereConditionBaseTParent.)
Public methodWhereNull(String)
Adds the where condition for a null column value
(Inherited from WhereConditionBaseTParent.)
Public methodWhereNull(IQueryObjectWithValue)
Adds the where condition for a null expression value
(Inherited from WhereConditionBaseTParent.)
Public methodWhereStartsWith(String, String)
Adds the condition for a string column to start with some prefix
(Inherited from WhereConditionBaseTParent.)
Public methodWhereStartsWith(IQueryObjectWithValue, String)
Adds the condition for a string column to start with some prefix
(Inherited from WhereConditionBaseTParent.)
Public methodWhereTrue(String)
Adds the where condition for a true column value (boolean column equals true).
(Inherited from WhereConditionBaseTParent.)
Public methodWhereTrue(IQueryObjectWithValue)
Adds the where condition for a true expression value (boolean expression equals true).
(Inherited from WhereConditionBaseTParent.)
Public methodWithComment
Adds the comment to the given query
Top
Extension Methods
See Also