IObjectQuery Interface

Interface for the object query

Namespace: CMS.DataEngine
Assembly: CMS.DataEngine (in CMS.DataEngine.dll) Version: 8.2.23

Syntax

public interface IObjectQuery : IDataQuery, 
	IDataQuerySettings, IWhereCondition, IQueryParameters, IDisposable, IQueryObjectWithValue, 
	IQueryObject

The IObjectQuery type exposes the following members.

Methods

	Name	Description
Public method	ApplyParametersTo	Applies this where condition to the target object (Inherited from IQueryParameters.)
Public method	ApplySettings(AbstractQueryObject)	Applies the given settings to the query (Inherited from IDataQuery.)
Public method	ApplySettings(Action<DataQuerySettings>)	Applies the given settings to the query (Inherited from IDataQuery.)
Public method	As<T>	Changes the type of the query to another type (Inherited from IDataQuery.)
Public method	AsIDQuery	Creates an ID query from the given query (Inherited from IDataQuery.)
Public method	AsMaterializedList	Makes a materialized list from the given query (Inherited from IDataQuery.)
Public method	AsNested<TResult>	Creates a nested query from the given query (Inherited from IDataQuery.)
Public method	AsSingleColumn	Creates a single column query from the given query (Inherited from IDataQuery.)
Public method	AsSubQuery	Modifies the query to be able to be used as a sub-query, e.g. for usage in WHERE A IN ([query]). Ensures single column result, and removes order by from the result. (Inherited from IDataQuery.)
Public method	AsValue	Gets a query expression representing this object as a value (Inherited from IQueryObjectWithValue.)
Public method	CloneObject	Creates the clone of the object. (Inherited from IQueryObject.)
Public method	EnsureParameters	Ensures data parameters for the given query (Inherited from IQueryParameters.)
Public method	Execute	Executes the current query and returns it's results as a DataSet (Inherited from IDataQuery.)
Public method	ExecuteReader	Executes the current query and returns it's results as a data reader (Inherited from IDataQuery.)
Public method	Expand	Expands the expression by replacing parameters with their values (Inherited from IQueryParameters.)
Public method	ForEachRow	Executes the given action for each item (DataRow) in the result. Processes the items in batches of the given size. (Inherited from IDataQuery.)
Public method	GetCompleteSettings	Gets the complete parameters for the query execution (Inherited from IDataQuery.)
Public method	GetExecutingQuery	Gets the query to execute against database (Inherited from IDataQuery.)
Public method	GetExpression	Gets a string expression representing this object (Inherited from IQueryObjectWithValue.)
Public method	GetFullQueryText	Gets the full query text including resolved parameters (Inherited from IDataQuery.)
Public method	GetListResult<T>	Gets the result as a list of values from the first column that the query returns. Excludes null values from the result. (Inherited from IDataQuery.)
Public method	GetScalarResult<T>	Gets the scalar (Inherited from IDataQuery.)
Public method	HasCompatibleSource	Returns true if the given query is an external source (Inherited from IDataQuery.)
Public method	Changed	Marks the object as changed (Inherited from IQueryObject.)
Public method	IncludeDataParameters	Adds the data parameters to the current query parameters (Inherited from IQueryObject.)
Public method	ReturnNoResults	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 IWhereCondition.)
Public method	Select<T>	Transforms the current result (Inherited from IDataQuery.)
Public method	ToString	Returns the string representation of the expression, with possibility of expanding parameters (Inherited from IQueryParameters.)

Extension Methods

	Name	Description
Public Extension Method	FakeExecution	Fakes the execution of a query (Defined by UnitTestExtensions.)
Public Extension Method	GetObjectRelationships	Gets the query for all relationships of the objects that the query represents (Defined by RelationshipsExtensions.)

Properties

	Name	Description
Public property	AllowMaterialization	If true, the query allows materialization (Inherited from IDataQuery.)
Public property	ClassName	Class name (Inherited from IDataQuery.)
Public property	ConnectionStringName	Query connection string name (Inherited from IDataQuery.)
Public property	Count	Number of actual records retrieved from the database (Inherited from IDataQuery.)
Public property	CustomQueryText	Custom query text (Inherited from IDataQuery.)
Public property	DataSource	Data source that provides the query data. If not set, the query queries the database directly (Inherited from IDataQuery.)
Public property	DataSourceName	Gets the unique query source ID (Inherited from IDataQuery.)
Public property	DefaultOrderByColumns	Default order by columns used in case if needed, and order by is not specified (Inherited from IDataQuery.)
Public property	DefaultSourceExpression	Default source of the query in case source is not defined (Inherited from IDataQuerySettings.)
Public property	FilterColumns	List of columns used for extra filtering within the query, e.g. "CMS_C, CMS_RN" (Inherited from IDataQuerySettings.)
Public property	GroupByColumns	List of columns to group by, by default doesn't group, e.g. "NodeLevel, NodeOwner" (Inherited from IDataQuerySettings.)
Public property	HasDataSource	Returns true if the query has specific data source (Inherited from IDataQuery.)
Public property	HavingCondition	Where condition for the group by on the data, e.g. "DocumentName = 'ABC'" (Inherited from IDataQuerySettings.)
Public property	IncludeBinaryData	If true, the query includes the object binary data. Default is false (Inherited from IDataQuery.)
Public property	IsCombinedQuery	If true, this query is combined from several queries. When additional parameters are applied to it, it will be wrapped into a nested query. (Inherited from IDataQuery.)
Public property	IsNested	Indicates that this query is part of multi query (Inherited from IDataQuerySettings.)
Public property	IsSubQuery	If true, the query is a sub-query used in another query (Inherited from IDataQuerySettings.)
Public property	MaxRecords	Maximum number of results to return (use for paging together with Offset) (Inherited from IDataQuerySettings.)
Public property	Name	Object name, empty by default (Inherited from IQueryObject.)
Public property	ObjectType	Returns the object type of the objects stored within the collection.
Public property	Offset	Index of the first record to return (use for paging together with MaxRecords) (Inherited from IDataQuerySettings.)
Public property	OrderByColumns	List of columns by which the result should be sorted, e.g. "NodeLevel, DocumentName DESC" (Inherited from IDataQuerySettings.)
Public property	Parameters	Query data parameters (Inherited from IQueryObject.)
Public property	QueryName	Query name (Inherited from IDataQuery.)
Public property	QueryText	Query text (Inherited from IDataQuery.)
Public property	Result	DataSet with the result (Inherited from IDataQuery.)
Public property	ReturnsSingleColumn	Returns true if the query returns single column (Inherited from IDataQuery.)
Public property	SelectColumns	Obsolete. List of columns to return, by default returns all columns, e.g. "DocumentName, DocumentID" (Inherited from IDataQuerySettings.)
Public property	SelectColumnsList	List of columns to return, by default returns all columns, e.g. "DocumentName, DocumentID" (Inherited from IDataQuerySettings.)
Public property	SelectDistinct	If set to true, returns only distinct (different) values. (Inherited from IDataQuerySettings.)
Public property	SourceExpression	Source of the query (Inherited from IDataQuerySettings.)
Public property	SupportsReader	Returns true if the query supports data reader (Inherited from IDataQuery.)
Public property	Tables	Collection of the result tables (Inherited from IDataQuery.)
Public property	TopNRecords	If set, selects only first top N number of records (Inherited from IDataQuerySettings.)
Public property	TotalRecords	Gets the number of total records when paging is used. Gets updated once the query executes (Inherited from IDataQuery.)
Public property	UseObjectTypeCondition	If true, the query uses the object type condition.
Public property	WhereCondition	Where condition on the data, e.g. "DocumentName = 'ABC'" (Inherited from IWhereCondition.)
Public property	WhereIsComplex	Returns true if the given where condition contains compound conditions, e. g. "A > 1 AND B = 5" (Inherited from IWhereCondition.)