RetrievalQuery Class

CTor

CTor

Gets or sets how long the resulset as a cached resultset should be placed in the cache.

Gets or sets a value indicating whether the resultset should be cached.

Gets or sets the tag the resultset should be cached under. By default this is the empty string (no tag)

The command used for this query.

The connection object to use with the Command

Only valid when RequiresClientSidePaging is set to true. Required to calculate the actual page start.

Only valid when RequiresClientSidePaging is set to true. Required to calculate the actual page start.

Gets a value indicating whether name overwriting has to take place (false) or not (true). Is true when this query was created from a proc call where name overwriting was already applied.

if set to true it will replace an existing cached set with the one specified.

List with the IParameterFieldRelation instances for the relations between entity fields and output parameters.

The list of parameters used in the Command.

Gets or sets the optional tag for the SQL query/queries to relate SQL strings in an RDBMS with an origin.

Flag to tell the object fetcher to use manual distinct filtering, as the DISTINCT command couldn't be applied. Used to tell paging wrappers to set RequiresClientSidePaging.

Gets / sets the flag which signals fetch code to use client side (i.e. in code) limitation logic and it should not rely on the amount of rows returned for row limitations. This flag is set by DQEs if DISTINCT can't be used but row limitations are required and TOP is thus not reliable. Default: false. If true, ManualRowsToTake is the amount to read.

Flag to tell the object fetcher to use manual paging. This is required when DISTINCT is required however due to DISTINCT violating types it can't be applied to the query. This then causes duplicates in the resultset, which shouldn't be there and thus causing pages with much lesser data. Only set by a DQE, normally false.

Gets or sets the resultset number to retrieve. This is a 1-based number (so first resultset is numbered '1', which is also the default). If set to 2 or higher, Execute will call NextResult() on the datareader till the required resultset is reached or NextResult returns false. If set to 0 or lower, the value is ignored.

Adds the output parameter value for synchronization with the enclosed DbParameter, after the query has been executed.

Adds the parameter to the query's command.

Adds a new IParameterFieldRelation to the collection of ParameterFieldRelations. An output parameter can be stored once in the collection.

Adds a new IParameterFieldRelation to the collection of ParameterFieldRelations. An output parameter can be stored once in the collection.

Adds the parameters to the query's command.

Caches the current row of the datareader as-is in the cached resultset.

Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources.

Performs the dispose action.

Determines whether the specified object is equal to the current object.

Executes the query contained by the IQuery instance. The connection has to be opened before calling Execute().

Async variant of Execute(CommandBehavior). Executes the query contained by the IQuery instance. The connection has to be opened before calling Execute().

Executes the query contained by the IQuery instance as a scalar query.

Async variant of ExecuteScalar. Executes the query contained by the IQuery instance as a scalar query.

Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection.

Gets the exception info using the info retriever set to this query object.

Serves as the default hash function.

Gets the Type of the current instance.

Creates a shallow copy of the current Object.

Merges the passed in elements in toMerge into this instance. It's up to the caller to remove the elements from the set passed in.

Called when the consumer is done with the resultset read. Call this method to signal that the retrievalquery can cache its resultset, if required.

Reflects the output values of output parameters in parameter values, if any.

Will walk all IParameterFieldRelation instances of this query and reflect the parameter values in the related fields. Only output parameters are taken into account. Used by Insert queries which retrieve Identity / sequence values back from the database after a succesful insert.

Sets the command text to the text specified

Sets the command timeout.

Overloaded ToString implementation

Overloaded ToString implementation

Wires the command of this query with the transaction passed in.