SD.LLBLGen.Pro.ORMSupportClasses

Base class for DAA classes which are generated and which serves as an in-between type between those generated classes and the actual implementation in DataAccessAdapterCore. This class contains overrides of the actual action methods in DataAccessAdapterCore so they can be executed with a strategy.

CTor

The persistence info provider.

Executes the specified plain SQL query using this adapter. Every parameter value is converted into one or more parameters which have to be pre-defined in the sqlQuery

The SQL query to execute. Should contain parameter names for the parameter values, or placeholders for parameter sets. See documentation for details regarding format specifics. The object containing the parameter values to use in the query. If it's an object array, parameters using ordening are assumed, otherwise for each public, non-static property, a parameter is created. The value returned by the executed DbCommand. In general this is the number of rows affected by the executed sqlQuery

Executes the specified plain SQL query using this adapter and projects each row in the resultset to an instance of T. Every parameter value is converted into one or more parameters which have to be pre-defined in the sqlQuery.

The type of the element to project each row to. The fetch aspects for this query. Can be null, in which case the defaults are used. The SQL query to execute, which returns a resultset. Should contain parameter names for the parameter values, or placeholders for parameter sets. See documentation for details regarding format specifics. The object containing the parameter values to use in the query. If it's an object array, parameters using ordening are assumed, otherwise for each public, non-static property, a parameter is created. A list with 0 or more instances of T, one for each row in the resultset obtained from executing the query constructed from sqlQuery and the specified parameters

Executes the passed in retrievalquery and projects the resultset onto instances of T (each row is materialized into an instance of T). If a transaction is in progress, the command is wired to the transaction and executed inside the transaction.

Type of the return elements, one for each row The query to execute. List of instances of T, one for each row in the resultset of queryToExecute

Projects the current resultset of the passed in datareader using the value projectors and the projector specified. The reader will be left open

Type of the return elements, one for each row The open reader to project the active resultset of the query object executed which produced the reader. Pass the executed query object to make sure resultset caching is possible. List of instances of T, one for each row in the resultset of reader Use this overload together with FetchDataReader if your datareader contains multiple resultsets, so you have fine-grained control over how you want to project which resultset in the datareader. Resultset caching will occur if the passed in executedQuery is setup to cache its resultset.

Deletes all entities of the name passed in as entityName (e.g. "CustomerEntity") from the persistent storage if they match the filter supplied in filterBucket.

The name of the entity to retrieve persistence information. For example "CustomerEntity". This name can be retrieved from an existing entity's LLBLGenProEntityName property. filter information to filter out the entities to delete the amount of physically deleted entities Not supported for entities which are in a TargetPerEntity hierarchy.
This overload doesn't support Authorization or Auditing. It's recommended, if you want to use authorization and/or auditing on this method, use the overload of DeleteEntitiesDirectly which accepts a type.

Deletes all entities of the name passed in as entityName (e.g. "CustomerEntity") from the persistent storage if they match the filter supplied in filterBucket.

The type of the entity to retrieve persistence information. filter information to filter out the entities to delete the amount of physically deleted entities Not supported for entities which are in a TargetPerEntity hierarchy.
This overload performs authorization. Use this overload instead of the one which accepts a name instead of a type instance if you want to have authorization support at runtime.

Deletes the specified entity from the persistent storage. The entity is not usable after this call, the state is set to OutOfSync. Will use the current transaction if a transaction is in progress.

The entity instance to delete from the persistent storage Predicate expression, meant for concurrency checks in a delete query true if the delete was succesful, otherwise false.

EntityCollection with one or more dirty entities which have to be persisted the amount of physically deleted entities

The entity object in which the fetched entity data will be stored. The primary key fields have to have a value. The prefetch path to use for this fetch, which will fetch all related entities defined by the path as well. The context to add the entity to if the fetch was succesful, and before the prefetch path is fetched. This ensures that the prefetch path is fetched using the context specified and will re-use already loaded entity objects. The list of IEntityField2 objects which have to be excluded or included for the fetch. If null or empty, all fields are fetched (default). If an instance of ExcludeIncludeFieldsList is passed in and its ExcludeContainedFields property is set to false, the fields contained in excludedIncludedFields are kept in the query, the rest of the fields in the query are excluded. true if the Fetch was succesful, false otherwise Will use a current transaction if a transaction is in progress, so MVCC or other concurrency scheme used by the database can be utilized

Fetches one or more entities which match the filter information in the parameters into the EntityCollection passed. The entity collection object has to contain an entity factory object which will be the factory for the entity instances to be fetched. It will apply paging and it will from there use a prefetch path fetch using the read page. It's important that pageSize is smaller than the set 'ParameterisedPrefetchPathThreshold'. If pagesize is larger than the limits set for the 'ParameterisedPrefetchPathThreshold' value, the query is likely to be slower than expected, though will work. If pageNumber / pageSize are set to values which disable paging, a normal prefetch path fetch will be performed.

The parameters.

Fetches the entity using unique constraint.

The entity to fetch. The unique constraint filter. The prefetch path. The context to use. The excluded included fields.

Fetches a new entity using the filter/relation combination filter passed in via filterBucket and the new entity is created using the passed in entity factory. Use this method when fetching a related entity using a current entity (for example, fetch the related Customer entity of an existing Order entity)

The factory which will be used to create a new entity object which will be fetched the completely filled in IRelationPredicateBucket object which will be used as a filter for the fetch. The fetch will only load the first entity loaded, even if the filter results into more entities being fetched The prefetch path to use for this fetch, which will fetch all related entities defined by the path as well. The context to add the entity to if the fetch was succesful, and before the prefetch path is fetched. This ensures that the prefetch path is fetched using the context specified and will re-use already loaded entity objects. The list of IEntityField2 objects which have to be excluded or included for the fetch. If null or empty, all fields are fetched (default). If an instance of ExcludeIncludeFieldsList is passed in and its ExcludeContainedFields property is set to false, the fields contained in excludedIncludedFields are kept in the query, the rest of the fields in the query are excluded. The new entity fetched, or a previous entity fetched if that entity was in the context specified

EntityCollection object containing one or more root objects which will contain the entities to fetch (and their paths) defined in the prefetch path. filter information used to retrieve the root entities. The maximum amount of entities to return limit used to retrieve the root entities. SortClause expression which was applied to the query executed to retrieve the root entities the PrefetchPath which defines the graph of objects to fetch.

Fetches the fields passed in fieldCollectionToFetch from the persistent storage using the relations and filter information stored in filterBucket into the DataTable object passed in. Use this routine to fill a typed list object. For TypedView filling, use the method FetchTypedView()

The datatable object to fill with the data for the fields in fieldCollectionToFetch The parameters.

Fetches the Typed View fields passed in fieldCollectionToFetch from the persistent storage using the query information stored in parameters into the DataTable object passed in. Use this routine to fill a TypedView object.

The data table to fill. The parameters.

Fetches the typed view, using the query specified.

The typed view to fill. The query to use. Used with stored procedure calling IRetrievalQuery instances to fill a typed view mapped onto a resultset. Be sure to call Dispose() on the passed in query, as it's not disposed in this method.

Executes the expression defined with the field in the fields collection specified, using the various elements defined. The expression is executed as a scalar query and a single value is returned.

IEntityFields2 instance with a single field with an expression defined and eventually aggregates filter to use The list of fields to group by on. When not specified or an empty collection is specified, no group by clause is added to the query. A check is performed for each field in the selectList. If a field in the selectList is not present in the groupByClause collection, an exception is thrown. The relations part of the filter. the value which is the result of the expression defined on the specified field

Gets the number of rows returned by a query for the fields specified, using the filter and groupby clause specified.

IEntityFields2 instance with the fields returned by the query to get the rowcount for filter to use by the query to get the rowcount for The list of fields to group by on. When not specified or an empty collection is specified, no group by clause is added to the query. A check is performed for each field in the selectList. If a field in the selectList is not present in the groupByClause collection, an exception is thrown. When true, it will not filter out duplicate rows, otherwise it will DISTINCT duplicate rows. the number of rows the query for the fields specified, using the filter, relations and groupbyClause specified. This method performs a SELECT COUNT(*) FROM (actual query) and executes that as a scalar query. This construct is not supported on Firebird. You can try to achieve the same results by using GetScalar and AggregateFunction.CountRow, though those results can differ from the result returned by GetDbCount if you use a group by clause.

Saves the passed in entity to the persistent storage. If the entity is new, it will be inserted, if the entity is existent, the changed entity fields will be changed in the database.

The entity to save When true, it will refetch the entity from the persistent storage so it will be up-to-date after the save action. Predicate expression, meant for concurrency checks in an Update query. Will be ignored if the entity is new. This predicate is used instead of a predicate produced by a set ConcurrencyPredicateFactory. When true, it will save all dirty objects referenced (directly or indirectly) by entityToSave also. true if the save was succesful, false otherwise. Will use a current transaction if a transaction is in progress

Saves all dirty objects inside the collection passed to the persistent storage. It will do this inside a transaction if a transaction is not yet available.

EntityCollection with one or more dirty entities which have to be persisted Refetches a saved entity from the database, so the entity will not be 'out of sync' When true, it will save all dirty objects referenced (directly or indirectly) by the entities inside collectionToSave also. the amount of persisted entities

Updates all entities of the same type or subtype of the entity entityWithNewValues directly in the persistent storage if they match the filter supplied in filterBucket. Only the fields changed in entityWithNewValues are updated for these fields. Entities of a subtype of the type of entityWithNewValues which are affected by the filterBucket's filter will thus also be updated.

Entity object which contains the new values for the entities of the same type and which match the filter in filterBucket. Only fields which are changed are updated. filter information to filter out the entities to update. the number of physically updated entities. Use this number only to test if the update succeeded (so value is > 0).

Creates a new Retrieval query from the elements passed in, executes that retrievalquery and projects the resultset of that query using the value projectors and the projector specified. If a transaction is in progress, the command is wired to the transaction and executed inside the transaction. The projection results will be stored in the projector.

The value projectors. The projector to use for projecting a plain row onto a new object provided by the projector. The parameters.

Executes the passed in retrievalquery and projects the resultset using the value projectors and the projector specified. IF a transaction is in progress, the command is wired to the transaction and executed inside the transaction. The projection results will be stored in the projector.

The value projectors. The projector to use for projecting a plain row onto a new object provided by the projector. The query to execute.

Loads the data for the excluded fields specified in the list of excluded fields into all the entities in the entities collection passed in.

The entities to load the excluded field data into. The entities have to be either of the same type or have to be in the same inheritance hierarchy as the entity which factory is set in the collection. The excludedIncludedFields object as it is used when fetching the passed in collection. If you used the excludedIncludedFields object to fetch only the fields in that list (i.e. excludedIncludedFields.ExcludeContainedFields==false), the routine will fetch all other fields in the resultset for the entities in the collection excluding the fields in excludedIncludedFields. The field data is set like a normal field value set, so authorization is applied to it. This routine batches fetches to have at most 5*ParameterizedThreshold of parameters per fetch. Keep in mind that most databases have a limit on the # of parameters per query.

Async variant of Executes the specified plain SQL query using this adapter. Every parameter value is converted into one or more parameters which have to be pre-defined in the sqlQuery

The cancellation token. The SQL query to execute. Should contain parameter names for the parameter values, or placeholders for parameter sets. See documentation for details regarding format specifics. The object containing the parameter values to use in the query. If it's an object array, parameters using ordening are assumed, otherwise for each public, non-static property, a parameter is created. The value returned by the executed DbCommand. In general this is the number of rows affected by the executed sqlQuery

Async variant of Executes the specified plain SQL query using this adapter and projects each row in the resultset to an instance of T. Every parameter value is converted into one or more parameters which have to be pre-defined in the sqlQuery.

The type of the element to project each row to. The cancellation token. The fetch aspects for this query. Can be null, in which case the defaults are used. The SQL query to execute, which returns a resultset. Should contain parameter names for the parameter values, or placeholders for parameter sets. See documentation for details regarding format specifics. The object containing the parameter values to use in the query. If it's an object array, parameters using ordening are assumed, otherwise for each public, non-static property, a parameter is created. A list with 0 or more instances of T, one for each row in the resultset obtained from executing the query constructed from sqlQuery and the specified parameters

Async variant of . Loads the data for the excluded fields specified in the list of excluded fields into all the entities in the entities collection passed in.

The entities to load the excluded field data into. The entities have to be either of the same type or have to be in the same inheritance hierarchy as the entity which factory is set in the collection. The excludedIncludedFields object as it is used when fetching the passed in collection. If you used the excludedIncludedFields object to fetch only the fields in that list (i.e. excludedIncludedFields.ExcludeContainedFields==false), the routine will fetch all other fields in the resultset for the entities in the collection excluding the fields in excludedIncludedFields. The cancellation token. The field data is set like a normal field value set, so authorization is applied to it. This routine batches fetches to have at most 5*ParameterizedThreshold of parameters per fetch. Keep in mind that most databases have a limit on the # of parameters per query.

Async variant of . Fetches one or more entities which match the filter information in the parameters into the EntityCollection passed. The entity collection object has to contain an entity factory object which will be the factory for the entity instances to be fetched. It will apply paging and it will from there use a prefetch path fetch using the read page. It's important that pageSize is smaller than the set 'ParameterisedPrefetchPathThreshold. If pagesize is larger than the limits set for the 'ParameterisedPrefetchPathThreshold' value, the query is likely to be slower than expected, though will work. If pageNumber / pageSize are set to values which disable paging, a normal prefetch path fetch will be performed.

The parameters. The cancellation token. Async variant

Async variant of . Fetches the fields passed in fieldCollectionToFetch from the persistent storage using the relations and filter information stored in filterBucket into the DataTable object passed in. Use this routine to fill a typed list object. For TypedView filling, use the method FetchTypedView()

The datatable object to fill with the data for the fields in fieldCollectionToFetch The parameters. The cancellation token.

Async variant of Executes the passed in retrievalquery and projects the resultset using the value projectors and the projector specified. IF a transaction is in progress, the command is wired to the transaction and executed inside the transaction. The projection results will be stored in the projector.

The value projectors. The projector to use for projecting a plain row onto a new object provided by the projector. The query to execute. The fields in projection, which are used to determine the type converters to use. if set to true the projection method will perform value projections on the plain row prior to using it in the projector and will create a new object row to store the projected values in. If false, the plain row is passed on as-is The cancellation token.

Async variant of . Creates a new Retrieval query from the elements passed in, executes that retrievalquery and projects the resultset of that query using the value projectors and the projector specified. If a transaction is in progress, the command is wired to the transaction and executed inside the transaction. The projection results will be stored in the projector.

The value projectors. The projector to use for projecting a plain row onto a new object provided by the projector. The parameters. The cancellation token.

Async variant of Executes the passed in retrievalquery and projects the resultset onto instances of T (each row is materialized into an instance of T). If a transaction is in progress, the command is wired to the transaction and executed inside the transaction.

The query to execute. The cancellation token. List of instances of T, one for each row in the resultset of queryToExecute

Async variant of . Deletes all entities of the name passed in as entityName (e.g. "CustomerEntity") from the persistent storage if they match the filter supplied in filterBucket.

The name of the entity to retrieve persistence information. For example "CustomerEntity". This name can be retrieved from an existing entity's LLBLGenProEntityName property. filter information to filter out the entities to delete The cancellation token. the amount of physically deleted entities Not supported for entities which are in a TargetPerEntity hierarchy.
This overload doesn't support Authorization or Auditing. It's recommended, if you want to use authorization and/or auditing on this method, use the overload of DeleteEntitiesDirectly which accepts a type.

Async variant of . Deletes all entities of the type passed in from the persistent storage if they match the filter supplied in filterBucket.

The type of the entity to retrieve persistence information. filter information to filter out the entities to delete The cancellation token. the amount of physically deleted entities Not supported for entities which are in a TargetPerEntity hierarchy.
This overload performs authorization. Use this overload instead of the one which accepts a name instead of a type instance if you want to have authorization support at runtime.

Async variant of . Updates all entities of the same type or subtype of the entity entityWithNewValues directly in the persistent storage if they match the filter supplied in filterBucket. Only the fields changed in entityWithNewValues are updated for these fields. Entities of a subtype of the type of entityWithNewValues which are affected by the filterBucket's filter will thus also be updated.

Entity object which contains the new values for the entities of the same type and which match the filter in filterBucket. Only fields which are changed are updated. filter information to filter out the entities to update. The cancellation token. the number of physically updated entities. Use this number only to test if the update succeeded (so value is > 0).

The entity to save When true, it will refetch the entity from the persistent storage so it will be up-to-date after the save action. Predicate expression, meant for concurrency checks in an Update query. Will be ignored if the entity is new. This predicate is used instead of a predicate produced by a set ConcurrencyPredicateFactory. When true, it will save all dirty objects referenced (directly or indirectly) by entityToSave also. The cancellation token. true if the save was succesful, false otherwise. Will use a current transaction if a transaction is in progress

Async variant of . Saves all dirty objects inside the collection passed to the persistent storage. It will do this inside a transaction if a transaction is not yet available.

Async variant of . Deletes all dirty objects inside the collection passed from the persistent storage. It will do this inside a transaction if a transaction is not yet available. Entities which are physically deleted from the persistent storage are marked with the state 'Deleted' but are not removed from the collection.

EntityCollection with one or more dirty entities which have to be persisted The cancellation token. the amount of physically deleted entities

The entity instance to delete from the persistent storage Predicate expression, meant for concurrency checks in a delete query The cancellation token. true if the delete was succesful, otherwise false.

The core call of an action stored procedure call. Executes the command specified and opens the connection if required.

The command. the value returned by the ExecuteNonQuery call

The core call of a retrieval stored procedure call. Performs a fill operation on the adapter for the dataset specified

The data set to fill. The adapter.

The core call of a retrieval stored procedure call. Performs a fill operation on the adapter for the datatable specified

The data table to fill. The adapter.

Creates the recovery strategy object to use. By default it returns null, which means no strategy is used. This method is only called if the property ActiveRecoveryStrategy is set to null. When a valid RecoveryStrategy instance is returned, it's stored in the ActiveRecoveryStrategy property and this method isn't called again until that property is set to null. Do not share recovery strategy instances among threads nor among DataAccessAdapter instances.

the recovery strategy object to use for this adapter, or null (default) if no strategy has to be used.

Obtains the active recovery strategy to use. Will use the strategy set in ActiveRecoveryStrategy. If the property is null, the method CreateRecoveryStrategyToUse is called and the value returned is stored in the ActiveRecoveryStrategy property.

The active recovery strategy to use for a query, or null if UseRecoveryStrategy is set to false or there's no active recovery strategy set.

Executes the specified action with the active recovery strategy on this adapter. If no recovery strategy is specified it will execute the action directly

To execute. No action specified to execute

Executes the specified func with the active recovery strategy on this adapter and will return the result. If no recovery strategy is specified it will execute the func directly

the type of the return value To execute. the result of the execution action of toExecute No action specified to execute

Executes the specified action with the active recovery strategy on this adapter. If no recovery strategy is specified it will execute the action directly. Async variant

To execute. The cancellation token. No action specified to execute

Executes the specified func with the active recovery strategy on this adapter and will return the result. If no recovery strategy is specified it will execute the func directly. Async variant

the type of the return value To execute. The cancellation token. the result of the execution action of toExecute No action specified to execute

Base class for DAA classes which are generated.

Enum which is used to signal the element removal routine what to do while removing hte elements. This is a performance issue, now the loop has to be run just once

No action

Call ITransactionalElement.TransactionCommit()

Call ITransactionalElement.TransactionRollback()

Raised when Commit was successful.

Raised when Rollback was successful.

CTor

The persistence info provider.

Calls the specified action stored procedure in the database. If a transaction is in progress, it will participate in that transaction.

Stored procedure to call array of parameters to pass the number of rows affected.

Calls the specified retrieval stored procedure in the database. Fills the specified datatable. Will participate in the transaction if a transaction is in progress.

Stored procedure to call array of parameters to specify Datatable to fill by the stored procedure true if succeeded, false otherwise

Calls the specified retrieval stored procedure in the database. Fills the specified DataSet. Will participate in the transaction if a transaction is in progress.

Stored procedure to call array of parameters to specify DataSet to fill by the stored procedure true if succeeded, false otherwise

Gets a scalar value, calculated with the aggregate and expression specified. the field specified is the field the expression and aggregate are applied on.

Field to which to apply the aggregate function and expression Aggregate function to apply. the scalar value requested

Gets a scalar value, calculated with the aggregate and expression specified. the field specified is the field the expression and aggregate are applied on.

Field to which to apply the aggregate function and expression The expression to execute. Can be null Aggregate function to apply. the scalar value requested

Gets a scalar value, calculated with the aggregate and expression specified. the field specified is the field the expression and aggregate are applied on.

Field to which to apply the aggregate function and expression The expression to execute. Can be null Aggregate function to apply. The filter to apply to retrieve the scalar the scalar value requested

Gets a scalar value, calculated with the aggregate and expression specified. the field specified is the field the expression and aggregate are applied on.

Field to which to apply the aggregate function and expression The expression to execute. Can be null Aggregate function to apply. The filter to apply to retrieve the scalar The groupby clause to apply to retrieve the scalar the scalar value requested

Gets a scalar value, calculated with the aggregate and expression specified. the field specified is the field the expression and aggregate are applied on.

Executes the expression defined with the field in the fields collection specified, using the various elements defined. The expression is executed as a scalar query and a single value is returned.

IEntityFields2 instance with a single field with an expression defined and eventually aggregates filter to use The list of fields to group by on. When not specified or an empty collection is specified, no group by clause is added to the query. A check is performed for each field in the selectList. If a field in the selectList is not present in the groupByClause collection, an exception is thrown. the value which is the result of the expression defined on the specified field

Executes the expression defined with the field in the fields collection specified, using the various elements defined. The expression is executed as a scalar query and a single value is returned.

Gets the estimated number of objects returned by a query for objects to store in the entity collection passed in, using the filter and groupby clause specified. The number is estimated as duplicate objects can be present in the plain query results, but will be filtered out when the query result is transformed into objects.

EntityCollection instance which will be fetched by the query to get the rowcount for filter to use by the query to get the rowcount for the number of rows the query for the fields specified, using the filter, relations and groupbyClause specified. This method performs a SELECT COUNT(*) FROM (actual query) and executes that as a scalar query. This construct is not supported on Firebird. You can try to achieve the same results by using GetScalar and AggregateFunction.CountRow, though those results can differ from the result returned by GetDbCount if you use a group by clause.

EntityCollection instance which will be fetched by the query to get the rowcount for filter to use by the query to get the rowcount for The list of fields to group by on. When not specified or an empty collection is specified, no group by clause is added to the query. A check is performed for each field in the selectList. If a field in the selectList is not present in the groupByClause collection, an exception is thrown. the number of rows the query for the fields specified, using the filter, relations and groupbyClause specified. This method performs a SELECT COUNT(*) FROM (actual query) and executes that as a scalar query. This construct is not supported on Firebird. You can try to achieve the same results by using GetScalar and AggregateFunction.CountRow, though those results can differ from the result returned by GetDbCount if you use a group by clause.

Gets the number of rows returned by a query for the fields specified, using the filter and groupby clause specified.

IEntityFields2 instance with the fields returned by the query to get the rowcount for filter to use by the query to get the rowcount for the number of rows the query for the fields specified, using the filter, relations and groupbyClause specified. This method performs a SELECT COUNT(*) FROM (actual query) and executes that as a scalar query. This construct is not supported on Firebird. You can try to achieve the same results by using GetScalar and AggregateFunction.CountRow, though those results can differ from the result returned by GetDbCount if you use a group by clause.

Gets the number of rows returned by a query for the fields specified, using the filter and groupby clause specified.

IEntityFields2 instance with the fields returned by the query to get the rowcount for filter to use by the query to get the rowcount for The list of fields to group by on. When not specified or an empty collection is specified, no group by clause is added to the query. A check is performed for each field in the selectList. If a field in the selectList is not present in the groupByClause collection, an exception is thrown. the number of rows the query for the fields specified, using the filter, relations and groupbyClause specified. This method performs a SELECT COUNT(*) FROM (actual query) and executes that as a scalar query. This construct is not supported on Firebird. You can try to achieve the same results by using GetScalar and AggregateFunction.CountRow, though those results can differ from the result returned by GetDbCount if you use a group by clause.

Gets the number of rows returned by a query for the fields specified, using the filter and groupby clause specified.

The type of the element to project each row to. The SQL query to execute, which returns a resultset. Should contain parameter names for the parameter values, or placeholders for parameter sets. See documentation for details regarding format specifics. The object containing the parameter values to use in the query. If it's an object array, parameters using ordening are assumed, otherwise for each public, non-static property, a parameter is created. A list with 0 or more instances of T, one for each row in the resultset obtained from executing the query constructed from sqlQuery and the specified parameters

Executes the specified plain SQL query using this adapter and returns the first scalar value returned as an instance of T. Every parameter value is converted into one or more parameters which have to be pre-defined in the sqlQuery. Uses default fetch aspects.

The type of the scalar value to return. The SQL query to execute, which returns a scalar value. Should contain parameter names for the parameter values, or placeholders for parameter sets. See documentation for details regarding format specifics. The object containing the parameter values to use in the query. If it's an object array, parameters using ordening are assumed, otherwise for each public, non-static property, a parameter is created. The first scalar value returned by the query as an instance of T or null if the query returned a NULL.

The type of the scalar value to return. The fetch aspects for this query. Can be null, in which case the defaults are used. The SQL query to execute, which returns a scalar value. Should contain parameter names for the parameter values, or placeholders for parameter sets. See documentation for details regarding format specifics. The object containing the parameter values to use in the query. If it's an object array, parameters using ordening are assumed, otherwise for each public, non-static property, a parameter is created. The first scalar value returned by the query as an instance of T or null if the query returned a NULL.

Async variant of .` Executes the specified plain SQL query using this adapter and returns the first scalar value returned as an instance of T. Every parameter value is converted into one or more parameters which have to be pre-defined in the sqlQuery. Uses default fetch aspects.

Async variant of . Executes the specified plain SQL query using this adapter and returns the first scalar value returned as an instance of T. Every parameter value is converted into one or more parameters which have to be pre-defined in the sqlQuery. Uses default fetch aspects.

The type of the scalar value to return. the cancellationToken The SQL query to execute, which returns a scalar value. Should contain parameter names for the parameter values, or placeholders for parameter sets. See documentation for details regarding format specifics. The object containing the parameter values to use in the query. If it's an object array, parameters using ordening are assumed, otherwise for each public, non-static property, a parameter is created. The first scalar value returned by the query as an instance of T or null if the query returned a NULL.

The type of the scalar value to return. the cancellationToken The fetch aspects for this query. Can be null, in which case the defaults are used. The SQL query to execute, which returns a scalar value. Should contain parameter names for the parameter values, or placeholders for parameter sets. See documentation for details regarding format specifics. The object containing the parameter values to use in the query. If it's an object array, parameters using ordening are assumed, otherwise for each public, non-static property, a parameter is created. The first scalar value returned by the query as an instance of T or null if the query returned a NULL.

Executes the specified plain SQL query using this adapter. Every parameter value is converted into one or more parameters which have to be pre-defined in the sqlQuery

Executes the passed in query as a scalar query and returns the value returned from this scalar execution.

a scalar query, which is a SELECT query which returns a single value the scalar value returned from the query.

Async variant of . Executes the passed in query as a scalar query and returns the value returned from this scalar execution.

a scalar query, which is a SELECT query which returns a single value the cancellation token the scalar value returned from the query.

Executes the passed in action query and, if not null, runs it inside the passed in transaction.

ActionQuery to execute. execution result, which is the amount of rows affected (if applicable)

Executes the passed in retrieval query and, if not null, runs it inside the passed in transaction. Used to read 1 row. It sets the connection object of the command object of query object passed in to the connection object of this class.

Retrieval query to execute The IEntityFields2 object to store the fetched data in The IFieldPersistenceInfo objects for the fieldsToFill fields

Executes the passed in retrieval query and, if not null, runs it inside the passed in transaction. Used to read 1 or more rows. It sets the connection object of the command object of query object passed in to the connection object of this class.

Retrieval query to execute the factory object which can produce the entities this method has to fill. Collection to fill with the retrieved rows. The persistence information for the fields of the entity created by entityFactory Flag to signal if duplicates in the datastream should be loaded into the collection (true) or not (false) Fields used for producing the query

Executes the passed in retrieval query and returns the results as a datatable using the passed in data-adapter. It sets the connection object of the command object of query object passed in to the connection object of this class.

Retrieval query to execute The dataadapter to use to fill the datatable. Fields persistence info objects for the fields used for the query. Required for type conversion on values. DataTable with the rows requested

Executes the passed in retrieval query and returns the results in thedatatable specified using the passed in data-adapter. It sets the connection object of the command object of query object passed in to the connection object of this class.

Retrieval query to execute The dataadapter to use to fill the datatable. DataTable to fill Fields persistence info objects for the fields used for the query. Required for type conversion on values. true if succeeded, false otherwise

Wires an active transaction to the command object of the passed in query. If no transaction is in progress, nothing is wired.

Query to wire up with the passed in transaction

Starts a new transaction. All database activity after this call will be ran in this transaction and all objects will participate in this transaction until its committed or rolled back. If there is a transaction in progress, an exception is thrown. Will create and open a new connection if a transaction is not open and/or available.

The isolation level to use for this transaction The name for this transaction If a transaction is already in progress. If this DataAccessAdapter is in a System.Transactions.Transaction, no real ado.net transaction will be started, as a transaction is already in progress. In that situation, this method will just open the connection if required.

Commits the transaction in action. It will end all database activity, since commiting a transaction is finalizing it. After calling Commit or Rollback, the ITransaction implementing class will reset itself. Will close the connection. If in a COM+ transaction: it will flag the context to commit. It will NOT set the done bit.

Will close the active connection unless KeepConnectionOpen has been set to true

Rolls back the transaction in action. It will end all database activity, since commiting a transaction is finalizing it. After calling Commit or Rollback, the ITransaction implementing class will reset itself. If in a COM+ transaction: it will flag the context to abort. It will NOT set the done bit.

Will close the active connection unless KeepConnectionOpen has been set to true

Opens the active connection object. If the connection is already open, nothing is done. If no connection object is present, a new one is created

Closes the active connection. If no connection is available or the connection is closed, nothing is done. If there is a transaction in progress, it's rolled back.

Saves the passed in entity to the persistent storage. Will not refetch the entity after this save. The entity will stay out-of-sync. If the entity is new, it will be inserted, if the entity is existent, the changed entity fields will be changed in the database. Will do a recursive save. Will pass the concurrency predicate returned by GetConcurrencyPredicate(ConcurrencyPredicateType.Save) as update restriction.

The entity to save true if the save was succesful, false otherwise. Will use a current transaction if a transaction is in progress

Saves the passed in entity to the persistent storage. If the entity is new, it will be inserted, if the entity is existent, the changed entity fields will be changed in the database. Will do a recursive save. Will pass the concurrency predicate returned by GetConcurrencyPredicate(ConcurrencyPredicateType.Save) as update restriction.

The entity to save When true, it will refetch the entity from the persistent storage so it will be up-to-date after the save action. true if the save was succesful, false otherwise. Will use a current transaction if a transaction is in progress

Saves the passed in entity to the persistent storage. If the entity is new, it will be inserted, if the entity is existent, the changed entity fields will be changed in the database. Will pass the concurrency predicate returned by GetConcurrencyPredicate(ConcurrencyPredicateType.Save) as update restriction.

The entity to save When true, it will refetch the entity from the persistent storage so it will be up-to-date after the save action. When true, it will save all dirty objects referenced (directly or indirectly) by entityToSave also. true if the save was succesful, false otherwise. Will use a current transaction if a transaction is in progress

The entity to save When true, it will refetch the entity from the persistent storage so it will be up-to-date after the save action. Predicate expression, meant for concurrency checks in an Update query. Will be ignored if the entity is new. This predicate is used instead of a predicate produced by a set ConcurrencyPredicateFactory. true if the save was succesful, false otherwise. Will use a current transaction if a transaction is in progress

Saves the passed in entity to the persistent storage. If the entity is new, it will be inserted, if the entity is existent, the changed entity fields will be changed in the database.

Persists the queue passed in. The queue contains ActionQueueElements and is in the right order, just save it from front to back

Queue to persist. if true, the actions to perform are insert actions, otherwise update actions the total amount of entities saved or -1 if the persist of the queue failed It assumes a transaction, if needed, is already created and opened, as well as a connection. All exceptions are bubbled upwards

Creates a new Retrieval query from the elements passed in and executes that retrievalquery to return an open, ready to use IDataReader. The datareader's command behavior is set to the readerBehavior passed in. If a transaction is in progress, the command is wired to the transaction.

The fields to use to build the query. The filter. The reader behavior to set. The max number of items to return. Specify 0 to return all elements If set to true, allow duplicates in the resultset, otherwise try to emit DISTINCT (if possible). Open, ready to use IDataReader Advanced functionality: be aware that the datareader returned is open, and the dataaccessadapter's connection is also open

The fields to use to build the query. The filter. The reader behavior to set. The max number of items to return. Specify 0 to return all elements The sort clauses. If set to true, allow duplicates in the resultset, otherwise try to emit DISTINCT (if possible). Open, ready to use IDataReader Advanced functionality: be aware that the datareader returned is open, and the dataaccessadapter's connection is also open

The fields to use to build the query. The filter. The reader behavior to set. The max number of items to return. Specify 0 to return all elements The sort clauses. If set to true, allow duplicates in the resultset, otherwise try to emit DISTINCT (if possible). The page number. Size of the page. Open, ready to use IDataReader Advanced functionality: be aware that the datareader returned is open, and the dataaccessadapter's connection is also open

The fields to use to build the query. The filter. The reader behavior to set. The max number of items to return. Specify 0 to return all elements The sort clauses. The group by clause. If set to true, allow duplicates in the resultset, otherwise try to emit DISTINCT (if possible). The page number. Size of the page. Open, ready to use IDataReader Advanced functionality: be aware that the datareader returned is open, and the dataaccessadapter's connection is also open

The reader behavior to set. The parameters. Open, ready to use IDataReader Advanced functionality: be aware that the datareader returned is open, and the dataaccessadapter's connection is also open

Executes the passed in retrievalquery and returns an open, ready to use IDataReader. The datareader's command behavior is set to the readerBehavior passed in. If a transaction is in progress, the command is wired to the transaction.

The query to execute. The reader behavior to set. Open, ready to use IDataReader Advanced functionality: be aware that the datareader returned is open, and the dataaccessadapter's connection is also open. It can be, if the query is set to cache its resultset, that the reader returned is actually a reader over the cached resultset. If you ordered the query to be cached, be sure to pass queryToExecute to the FetchProjection method to cache the resultset.

The value projectors. The projector to use for projecting a plain row onto a new object provided by the projector. The fields to use to build the query. The filter. The max number of items to return. Specify 0 to return all elements If set to true, allow duplicates in the resultset, otherwise it will emit DISTINCT into the query (if possible).

The value projectors. The projector to use for projecting a plain row onto a new object provided by the projector. The fields to use to build the query. The filter. The max number of items to return. Specify 0 to return all elements The sort clauses. If set to true, allow duplicates in the resultset, otherwise it will emit DISTINCT into the query (if possible).

The value projectors. The projector to use for projecting a plain row onto a new object provided by the projector. The fields to use to build the query. The filter. The max number of items to return. Specify 0 to return all elements The sort clauses. If set to true, allow duplicates in the resultset, otherwise it will emit DISTINCT into the query (if possible). The page number. Size of the page.

The value projectors. The projector to use for projecting a plain row onto a new object provided by the projector. The fields to use to build the query. The filter. The max number of items to return. Specify 0 to return all elements The sort clauses. The group by clause. If set to true, allow duplicates in the resultset, otherwise it will emit DISTINCT into the query (if possible). The page number. Size of the page.

The value projectors. The projector to use for projecting a plain row onto a new object provided by the projector. The parameters.

The value projectors. The projector to use for projecting a plain row onto a new object provided by the projector. The query to execute.

Projects the current resultset of the passed in datareader using the value projectors and the projector specified. The reader will be left open

The value projectors. The projector to use for projecting a plain row onto a new object provided by the projector. The reader which points to the first row of a resultset Use this overload together with FetchDataReader if your datareader contains multiple resultsets, so you have fine-grained control over how you want to project which resultset in the datareader. The resultset won't be cached in the resultset cache. To cache the resultset, use the overload which accepts the IRetrievalQuery executed

Projects the current resultset of the passed in datareader using the value projectors and the projector specified. The reader will be left open

The value projectors. The projector to use for projecting a plain row onto a new object provided by the projector. The reader which points to the first row of a resultset the query object executed which produced the reader. Pass the executed query object to make sure resultset caching is possible. Use this overload together with FetchDataReader if your datareader contains multiple resultsets, so you have fine-grained control over how you want to project which resultset in the datareader. Resultset caching will occur if the passed in executedQuery is setup to cache its resultset.

The entity object in which the fetched entity data will be stored. The primary key fields have to have a value. Will use a current transaction if a transaction is in progress, so MVCC or other concurrency scheme used by the database can be utilized true if the Fetch was succesful, false otherwise

The entity object in which the fetched entity data will be stored. The primary key fields have to have a value. The context to add the entity to if the fetch was succesful. Will use a current transaction if a transaction is in progress, so MVCC or other concurrency scheme used by the database can be utilized true if the Fetch was succesful, false otherwise

The entity object in which the fetched entity data will be stored. The primary key fields have to have a value. The prefetch path to use for this fetch, which will fetch all related entities defined by the path as well. Will use a current transaction if a transaction is in progress, so MVCC or other concurrency scheme used by the database can be utilized true if the Fetch was succesful, false otherwise

The entity object in which the fetched entity data will be stored. The primary key fields have to have a value. The prefetch path to use for this fetch, which will fetch all related entities defined by the path as well. The context to add the entity to if the fetch was succesful, and before the prefetch path is fetched. This ensures that the prefetch path is fetched using the context specified and will re-use already loaded entity objects. The list of IEntityField2 objects which have to be excluded or included for the fetch. If null or empty, all fields are fetched (default). If an instance of ExcludeIncludeFieldsList is passed in and its ExcludeContainedFields property is set to false, the fields contained in excludedIncludedFields are kept in the query, the rest of the fields in the query are excluded. Will use a current transaction if a transaction is in progress, so MVCC or other concurrency scheme used by the database can be utilized true if the Fetch was succesful, false otherwise

Fetches an entity from the persistent storage into the object specified using the filter specified. Use the entity's uniqueconstraint filter construction methods to construct the required uniqueConstraintFilter for the unique constraint you want to use.

The entity object in which the fetched entity data will be stored. The filter which should filter on fields with a unique constraint. true if the Fetch was succesful, false otherwise

The entity object in which the fetched entity data will be stored. The filter which should filter on fields with a unique constraint. The context to add the entity to if the fetch was succesful. true if the Fetch was succesful, false otherwise

The entity object in which the fetched entity data will be stored. The filter which should filter on fields with a unique constraint. The prefetch path to use for this fetch, which will fetch all related entities defined by the path as well. The context to add the entity to if the fetch was succesful, and before the prefetch path is fetched. This ensures that the prefetch path is fetched using the context specified and will re-use already loaded entity objects. The list of IEntityField2 objects which have to be excluded or included for the fetch. If null or empty, all fields are fetched (default). If an instance of ExcludeIncludeFieldsList is passed in and its ExcludeContainedFields property is set to false, the fields contained in excludedIncludedFields are kept in the query, the rest of the fields in the query are excluded. true if the Fetch was succesful, false otherwise

Fetches a new entity using the filter/relation combination filter passed in via filterBucket and the new entity is created using the specified generic type. Use this method when fetching a related entity using a current entity (for example, fetch the related Customer entity of an existing Order entity)

the completely filled in IRelationPredicateBucket object which will be used as a filter for the fetch. The fetch will only load the first entity loaded, even if the filter results into more entities being fetched The new entity fetched. The type of entity to fetch TEntity can't be a type which is an abstract entity. If you want to fetch an instance of an abstract entity (e.g. polymorphic fetch) please use the overload which accepts an entity factory instead

the completely filled in IRelationPredicateBucket object which will be used as a filter for the fetch. The fetch will only load the first entity loaded, even if the filter results into more entities being fetched The context to add the entity to if the fetch was succesful. The new entity fetched, or a previous entity fetched if that entity was in the context specified The type of entity to fetch TEntity can't be a type which is an abstract entity. If you want to fetch an instance of an abstract entity (e.g. polymorphic fetch) please use the overload which accepts an entity factory instead

the completely filled in IRelationPredicateBucket object which will be used as a filter for the fetch. The fetch will only load the first entity loaded, even if the filter results into more entities being fetched The prefetch path to use for this fetch, which will fetch all related entities defined by the path as well. The context to add the entity to if the fetch was succesful, and before the prefetch path is fetched. This ensures that the prefetch path is fetched using the context specified and will re-use already loaded entity objects. The list of IEntityField2 objects which have to be excluded or included for the fetch. If null or empty, all fields are fetched (default). If an instance of ExcludeIncludeFieldsList is passed in and its ExcludeContainedFields property is set to false, the fields contained in excludedIncludedFields are kept in the query, the rest of the fields in the query are excluded. The new entity fetched, or a previous entity fetched if that entity was in the context specified The type of entity to fetch TEntity can't be a type which is an abstract entity. If you want to fetch an instance of an abstract entity (e.g. polymorphic fetch) please use the overload which accepts an entity factory instead

Deletes the specified entity from the persistent storage. The entity is not usable after this call, the state is set to OutOfSync. Will use the current transaction if a transaction is in progress. If the passed in entity has a concurrency predicate factory object, the returned predicate expression is used to restrict the delete process.

The entity instance to delete from the persistent storage true if the delete was succesful, otherwise false.

Deletes the specified entity from the persistent storage. The entity is not usable after this call, the state is set to OutOfSync. Will use the current transaction if a transaction is in progress.

The entity instance to delete from the persistent storage Predicate expression, meant for concurrency checks in a delete query true if the delete was succesful, otherwise false. Will throw an ORMConcurrencyException if the delete fails.

EntityCollection object containing an entity factory which has to be filled The list of IEntityField2 objects which have to be excluded or included for the fetch. If null or empty, all fields are fetched (default). If an instance of ExcludeIncludeFieldsList is passed in and its ExcludeContainedFields property is set to false, the fields contained in excludedIncludedFields are kept in the query, the rest of the fields in the query are excluded. filter information for retrieving the entities. If null, all entities are returned of the type created by the factory in the passed in EntityCollection instance.

EntityCollection object containing an entity factory which has to be filled filter information for retrieving the entities. If null, all entities are returned of the type created by the factory in the passed in EntityCollection instance. The prefetch path to use for this fetch, which will fetch all related entities defined by the path as well.

EntityCollection object containing an entity factory which has to be filled filter information for retrieving the entities. If null, all entities are returned of the type created by the factory in the passed in EntityCollection instance. The maximum amount of entities to return. If 0, all entities matching the filter are returned SortClause expression which is applied to the query executed, sorting the fetch result. The prefetch path to use for this fetch, which will fetch all related entities defined by the path as well. The list of IEntityField2 objects which have to be excluded or included for the fetch. If null or empty, all fields are fetched (default). If an instance of ExcludeIncludeFieldsList is passed in and its ExcludeContainedFields property is set to false, the fields contained in excludedIncludedFields are kept in the query, the rest of the fields in the query are excluded. If the passed in collectionToFill doesn't contain an entity factory.

Fetches one or more entities which match the filter information in the filterBucket into the EntityCollection passed. The entity collection object has to contain an entity factory object which will be the factory for the entity instances to be fetched. It will apply paging and it will from there use a prefetch path fetch using the read page. It's important that pageSize is smaller than the set . If pagesize is larger than the limits set for the value, the query is likely to be slower than expected, though will work. If pageNumber / pageSize are set to values which disable paging, a normal prefetch path fetch will be performed.

EntityCollection object containing an entity factory which has to be filled filter information for retrieving the entities. If null, all entities are returned of the type created by the factory in the passed in EntityCollection instance. The maximum amount of entities to return. If 0, all entities matching the filter are returned SortClause expression which is applied to the query executed, sorting the fetch result. Prefetch path to use. The list of IEntityField2 objects which have to be excluded or included for the fetch. If null or empty, all fields are fetched (default). If an instance of ExcludeIncludeFieldsList is passed in and its ExcludeContainedFields property is set to false, the fields contained in excludedIncludedFields are kept in the query, the rest of the fields in the query are excluded. the page number to retrieve. First page is 1. When set to 0, no paging logic is applied the size of the page. When set to 0, no paging logic is applied If the passed in collectionToFill doesn't contain an entity factory. Special thanks to Marcus Mac Innes (http://www.styledesign.biz) for the paging optimization code.

Fetches one or more entities which match the filter information in the parameters into the EntityCollection passed. The entity collection object has to contain an entity factory object which will be the factory for the entity instances to be fetched. It will apply paging and it will from there use a prefetch path fetch using the read page. It's important that pageSize is smaller than the set . If pagesize is larger than the limits set for the value, the query is likely to be slower than expected, though will work. If pageNumber / pageSize are set to values which disable paging, a normal prefetch path fetch will be performed.

The parameters. If the passed in collectionToFill doesn't contain an entity factory.

Saves all dirty objects inside the collection passed to the persistent storage. It will do this inside a transaction if a transaction is not yet available. Will not refetch saved entities and will not recursively save the entities.

EntityCollection with one or more dirty entities which have to be persisted the amount of persisted entities

Saves all dirty objects inside the collection passed to the persistent storage. It will do this inside a transaction if a transaction is not yet available.

EntityCollection with one or more dirty entities which have to be persisted the amount of physically deleted entities

Deletes all entities of the name passed in as entityName (e.g. "CustomerEntity") from the persistent storage if they match the filter supplied in filterBucket.

Loads the data for the excluded fields specified in the list of excluded fields into the entity passed in.

The entity to load the excluded field data into. The excludedIncludedFields object as it is used when fetching the passed in entity. If you used the excludedIncludedFields object to fetch only the fields in that list (i.e. excludedIncludedFields.ExcludeContainedFields==false), the routine will fetch all other fields in the resultset for the entities in the collection excluding the fields in excludedIncludedFields. The field data is set like a normal field value set, so authorization is applied to it.

Loads the data for the excluded fields specified in the list of excluded fields into all the entities in the entities collection passed in.

Fetches the fields passed in fieldCollectionToFetch from the persistent storage using the relations and filter information stored in the passed in typed list. For TypedView filling, use the method FetchTypedView()

Typed list to fill. Grabs the fields list and relations set from the typed list passed in.

Typed list to fill. An additional filter to use to filter the fetch of the typed list. If you need a more sophisticated filter approach, please use the overload which accepts an IRelationalPredicateBucket and add your filter to the bucket you receive when calling typedListToFill.GetRelationInfo(). The maximum amount of rows to return. If 0, all rows matching the filter are returned SortClause expression which is applied to the query executed, sorting the fetch result. When true, it will not filter out duplicate rows, otherwise it will DISTINCT duplicate rows. Grabs the fields list and relations set from the typed list passed in.

Typed list to fill. An additional filter to use to filter the fetch of the typed list. If you need a more sophisticated filter approach, please use the overload which accepts an IRelationalPredicateBucket and add your filter to the bucket you receive when calling typedListToFill.GetRelationInfo(). The maximum amount of rows to return. If 0, all rows matching the filter are returned SortClause expression which is applied to the query executed, sorting the fetch result. When true, it will not filter out duplicate rows, otherwise it will DISTINCT duplicate rows. the page number to retrieve. First page is 1. When set to 0, no paging logic is applied the size of the page. When set to 0, no paging logic is applied Grabs the fields list and relations set from the typed list passed in.

Fetches the fields passed in fieldCollectionToFetch from the persistent storage using the relations and filter information stored in filterBucket into the DataTable object passed in. Use this routine to fill a typed list object. Doesn't apply any sorting, doesn't limit the resultset on the amount of rows to return, does allow duplicates. For TypedView filling, use the method FetchTypedView()

Fetches the fields passed in fieldCollectionToFetch from the persistent storage using the relations and filter information stored in filterBucket into the DataTable object passed in. Use this routine to fill a typed list object. Doesn't apply any sorting, doesn't limit the resultset on the amount of rows to return. For TypedView filling, use the method FetchTypedView()

IEntityField2 collection which contains the fields to fetch into the datatable. The fields inside this object are used to construct the selection resultset. The datatable object to fill with the data for the fields in fieldCollectionToFetch filter information (relations and predicate expressions) for retrieving the data. Use the TypedList's method GetRelationInfo() to retrieve this bucket. When true, it will not filter out duplicate rows, otherwise it will DISTINCT duplicate rows.

Fetches the fields passed in fieldCollectionToFetch from the persistent storage using the relations and filter information stored in filterBucket into the DataTable object passed in. Use this routine to fill a typed list object. Doesn't apply any sorting. For TypedView filling, use the method FetchTypedView()

IEntityField2 collection which contains the fields to fetch into the datatable. The fields inside this object are used to construct the selection resultset. The datatable object to fill with the data for the fields in fieldCollectionToFetch filter information (relations and predicate expressions) for retrieving the data. Use the TypedList's method GetRelationInfo() to retrieve this bucket. The maximum amount of rows to return. If 0, all rows matching the filter are returned When true, it will not filter out duplicate rows, otherwise it will DISTINCT duplicate rows.

IEntityField2 collection which contains the fields to fetch into the datatable. The fields inside this object are used to construct the selection resultset. Use the typed list's method GetFieldsInfo() to retrieve this IEntityField2 information The datatable object to fill with the data for the fields in fieldCollectionToFetch filter information (relations and predicate expressions) for retrieving the data. Use the TypedList's method GetRelationInfo() to retrieve this bucket. The maximum amount of rows to return. If 0, all rows matching the filter are returned SortClause expression which is applied to the query executed, sorting the fetch result. When true, it will not filter out duplicate rows, otherwise it will DISTINCT duplicate rows.

The datatable object to fill with the data for the fields in fieldCollectionToFetch The parameters. parameters

Fetches the typed view, using the query specified.

Fetches the Typed View passed in from the persistent storage Doesn't apply any sorting, doesn't limit the amount of rows returned by the query, doesn't apply any filtering, allows duplicate rows. Use this routine to fill a TypedView object.

Typed view to fill.

Fetches the Typed View passed in from the persistent storage Doesn't apply any sorting, doesn't limit the amount of rows returned by the query, doesn't apply any filtering. Use this routine to fill a TypedView object.

Typed view to fill. When true, it will not filter out duplicate rows, otherwise it will DISTINCT duplicate rows.

Fetches the Typed View passed in from the persistent storage Doesn't apply any sorting, doesn't limit the amount of rows returned by the query. Use this routine to fill a TypedView object.

Typed view to fill. filter information (relations and predicate expressions) for retrieving the data. Use the TypedList's method GetRelationInfo() to retrieve this bucket. When true, it will not filter out duplicate rows, otherwise it will DISTINCT duplicate rows.

Fetches the Typed View passed in from the persistent storage Doesn't apply any sorting. Use this routine to fill a TypedView object.

Typed view to fill. filter information (relations and predicate expressions) for retrieving the data. Use the TypedList's method GetRelationInfo() to retrieve this bucket. The maximum amount of rows to return. If 0, all rows matching the filter are returned When true, it will not filter out duplicate rows, otherwise it will DISTINCT duplicate rows.

Fetches the Typed View passed in from the persistent storage

Typed view to fill. filter information (relations and predicate expressions) for retrieving the data. The maximum amount of rows to return. If 0, all rows matching the filter are returned SortClause expression which is applied to the query executed, sorting the fetch result. When true, it will not filter out duplicate rows, otherwise it will DISTINCT duplicate rows. To fill a DataTable with entity rows, use this method as well, by passing the Fields collection of an entity of the same type as the one you want to fetch as fieldCollectionToFetch.

Fetches the Typed View passed in from the persistent storage

Typed view to fill. filter information (relations and predicate expressions) for retrieving the data. The maximum amount of rows to return. If 0, all rows matching the filter are returned SortClause expression which is applied to the query executed, sorting the fetch result. When true, it will not filter out duplicate rows, otherwise it will DISTINCT duplicate rows. GroupByCollection with fields to group by on To fill a DataTable with entity rows, use this method as well, by passing the Fields collection of an entity of the same type as the one you want to fetch as fieldCollectionToFetch.

Fetches the Typed View fields passed in fieldCollectionToFetch from the persistent storage into the DataTable object passed in. Doesn't apply any sorting, doesn't limit the amount of rows returned by the query, doesn't apply any filtering, allows duplicate rows. Use this routine to fill a TypedView object.

IEntityField2 collection which contains the fields of the typed view to fetch into the datatable. The datatable object to fill with the data for the fields in fieldCollectionToFetch

Fetches the Typed View fields passed in fieldCollectionToFetch from the persistent storage using the filter information stored in filterBucket into the DataTable object passed in. Doesn't apply any sorting, doesn't limit the amount of rows returned by the query. Use this routine to fill a TypedView object.

IEntityField2 collection which contains the fields of the typed view to fetch into the datatable. The datatable object to fill with the data for the fields in fieldCollectionToFetch filter information (relations and predicate expressions) for retrieving the data. Use the TypedList's method GetRelationInfo() to retrieve this bucket. When true, it will not filter out duplicate rows, otherwise it will DISTINCT duplicate rows.

IEntityField2 collection which contains the fields of the typed view to fetch into the datatable. The datatable object to fill with the data for the fields in fieldCollectionToFetch filter information (relations and predicate expressions) for retrieving the data. Use the TypedList's method GetRelationInfo() to retrieve this bucket. The maximum amount of rows to return. If 0, all rows matching the filter are returned When true, it will not filter out duplicate rows, otherwise it will DISTINCT duplicate rows.

IEntityField2 collection which contains the fields of the typed view to fetch into the datatable. Use the Typed View's method GetFieldsInfo() to get this IEntityField2 field collection The datatable object to fill with the data for the fields in fieldCollectionToFetch filter information (relations and predicate expressions) for retrieving the data. The maximum amount of rows to return. If 0, all rows matching the filter are returned SortClause expression which is applied to the query executed, sorting the fetch result. When true, it will not filter out duplicate rows, otherwise it will DISTINCT duplicate rows. To fill a DataTable with entity rows, use this method as well, by passing the Fields collection of an entity of the same type as the one you want to fetch as fieldCollectionToFetch.

IEntityField2 collection which contains the fields of the typed view to fetch into the datatable. Use the Typed View's method GetFieldsInfo() to get this IEntityField2 field collection The datatable object to fill with the data for the fields in fieldCollectionToFetch filter information (relations and predicate expressions) for retrieving the data. The maximum amount of rows to return. If 0, all rows matching the filter are returned SortClause expression which is applied to the query executed, sorting the fetch result. When true, it will not filter out duplicate rows, otherwise it will DISTINCT duplicate rows. GroupByCollection with fields to group by on To fill a DataTable with entity rows, use this method as well, by passing the Fields collection of an entity of the same type as the one you want to fetch as fieldCollectionToFetch.

IEntityField2 collection which contains the fields of the typed view to fetch into the datatable. Use the Typed View's method GetFieldsInfo() to get this IEntityField2 field collection The datatable object to fill with the data for the fields in fieldCollectionToFetch filter information (relations and predicate expressions) for retrieving the data. The maximum amount of rows to return. If 0, all rows matching the filter are returned SortClause expression which is applied to the query executed, sorting the fetch result. When true, it will not filter out duplicate rows, otherwise it will DISTINCT duplicate rows. GroupByCollection with fields to group by on the page number to retrieve. First page is 1. When set to 0, no paging logic is applied the size of the page. When set to 0, no paging logic is applied To fill a DataTable with entity rows, you could use this method as well, by passing the Fields collection of an entity of the same type as the one you want to fetch as fieldCollectionToFetch.

The data table to fill. The parameters. parameters

Creates a savepoint with the name savePointName in the current transaction. You can roll back to this savepoint using .

name of savepoint. Must be unique in an active transaction If no transaction is in progress. if savePointName is empty or null if the .NET database provider doesn't support transaction saving or when COM+ is used.

Rolls back the transaction in action to the savepoint with the name savepointName. No internal objects are being reset when this method is called, so call this Rollback overload only to roll back to a savepoint. To roll back a complete transaction, call Rollback() without specifying a savepoint name. Create a savepoint by calling SaveTransaction(savePointName)

If no transaction is in progress. if savePointName is empty or null if the .NET database provider doesn't support transaction rolling back a transaction to a named point or when COM+ is used. name of the savepoint to roll back to.

Creates a new predicate expression which filters on the primary key fields and the set values for the given primary key fields. If no primary key fields are specified, null is returned.

ArrayList with IEntityField2 instances which form the primary key for which the filter has to be constructed filled in predicate expression or null if no primary key fields are specified. Call this method passing IEntity2.Fields.PrimaryKeyFields

Creates for each entity which PK field(s) are in the passed in arraylist a new predicate expression which filters on the primary key fields of that entity and the set values for the given primary key fields. If no primary key fields are specified, null is returned.

ArrayList with IEntityField2 instances which form the primary key for which the filter has to be constructed ArrayList with for each entity a filled in predicate expression or null if no primary key fields are specified. PK filters are stored in the same order as entities appear in the pkfields, which is the same order in which entities are located in the hierarchy (from root to leaf) Call this method passing IEntity2.Fields.PrimaryKeyFields

Projects the current resultset of the passed in datareader using the value projectors and the projector specified. The reader will be left open

Type of the return elements, one for each row The open reader to project the active resultset of List of instances of T, one for each row in the resultset of reader Use this overload together with FetchDataReader if your datareader contains multiple resultsets, so you have fine-grained control over how you want to project which resultset in the datareader. Resultset caching will not occur. To use resultset caching, use the overload which accepts an IRetrievalQuery

Projects the current resultset of the passed in datareader using the value projectors and the projector specified. The reader will be left open

Type of the return elements, one for each row The query to execute. List of instances of T, one for each row in the resultset of queryToExecute

Async variant of Calls the specified action stored procedure in the database. If a transaction is in progress, it will participate in that transaction.

Stored procedure to call array of parameters to pass The cancellation token. the number of rows affected.

Async variant of . Loads the data for the excluded fields specified in the list of excluded fields into the entity passed in.

The entity to load the excluded field data into. The excludedIncludedFields object as it is used when fetching the passed in entity. If you used the excludedIncludedFields object to fetch only the fields in that list (i.e. excludedIncludedFields.ExcludeContainedFields==false), the routine will fetch all other fields in the resultset for the entities in the collection excluding the fields in excludedIncludedFields. The cancellation token. The field data is set like a normal field value set, so authorization is applied to it.

Async variant of . Loads the data for the excluded fields specified in the list of excluded fields into all the entities in the entities collection passed in.

The entities to load the excluded field data into. The entities have to be either of the same type or have to be in the same inheritance hierarchy as the entity which factory is set in the collection. The excludedIncludedFields object as it is used when fetching the passed in collection. If you used the excludedIncludedFields object to fetch only the fields in that list (i.e. excludedIncludedFields.ExcludeContainedFields==false), the routine will fetch all other fields in the resultset for the entities in the collection excluding the fields in excludedIncludedFields. The entity factory of the passed in entities collection is null. The field data is set like a normal field value set, so authorization is applied to it. This routine batches fetches to have at most 5*ParameterizedThreshold of parameters per fetch. Keep in mind that most databases have a limit on the # of parameters per query.

Async variant of . Loads the data for the excluded fields specified in the list of excluded fields into all the entities in the entities collection passed in.

The entities to load the excluded field data into. The entities have to be either of the same type or have to be in the same inheritance hierarchy as the entity which factory is set in the collection. The excludedIncludedFields object as it is used when fetching the passed in collection. If you used the excludedIncludedFields object to fetch only the fields in that list (i.e. excludedIncludedFields.ExcludeContainedFields==false), the routine will fetch all other fields in the resultset for the entities in the collection excluding the fields in excludedIncludedFields. The cancellation token. The entity factory of the passed in entities collection is null. The field data is set like a normal field value set, so authorization is applied to it. This routine batches fetches to have at most 5*ParameterizedThreshold of parameters per fetch. Keep in mind that most databases have a limit on the # of parameters per query.

Async variant of . Fetches one or more entities which match the filter information in the parameters into the EntityCollection passed. The entity collection object has to contain an entity factory object which will be the factory for the entity instances to be fetched. It will apply paging and it will from there use a prefetch path fetch using the read page. It's important that pageSize is smaller than the set . If pagesize is larger than the limits set for the value, the query is likely to be slower than expected, though will work. If pageNumber / pageSize are set to values which disable paging, a normal prefetch path fetch will be performed.

The parameters. The cancellation token. parameters If the passed in collectionToFill doesn't contain an entity factory. Async variant

The datatable object to fill with the data for the fields in fieldCollectionToFetch The parameters. The cancellation token. parameters

Async variant of . Creates a new Retrieval query from the elements passed in and executes that retrievalquery to return an open, ready to use IDataReader. The datareader's command behavior is set to the readerBehavior passed in. If a transaction is in progress, the command is wired to the transaction.

The reader behavior to set. The parameters. The cancellation token. Open, ready to use IDataReader parameters Advanced functionality: be aware that the datareader returned is open, and the dataaccessadapter's connection is also open

Async variant of . Executes the passed in retrievalquery and returns an open, ready to use IDataReader. The datareader's command behavior is set to the readerBehavior passed in. If a transaction is in progress, the command is wired to the transaction.

The query to execute. The reader behavior to set. The cancellation token. Open, ready to use IDataReader Advanced functionality: be aware that the datareader returned is open, and the dataaccessadapter's connection is also open. It can be, if the query is set to cache its resultset, that the reader returned is actually a reader over the cached resultset. If you ordered the query to be cached, be sure to pass queryToExecute to the FetchProjection method to cache the resultset.

The value projectors. The projector to use for projecting a plain row onto a new object provided by the projector. The query to execute. The cancellation token.

The value projectors. The projector to use for projecting a plain row onto a new object provided by the projector. The parameters. The cancellation token. parameters

The query to execute. List of instances of T, one for each row in the resultset of queryToExecute

The query to execute. The cancellation token. List of instances of T, one for each row in the resultset of queryToExecute

Async variant of . Deletes all entities of the name passed in as entityName (e.g. "CustomerEntity") from the persistent storage if they match the filter supplied in filterBucket.

The name of the entity to retrieve persistence information. For example "CustomerEntity". This name can be retrieved from an existing entity's LLBLGenProEntityName property. filter information to filter out the entities to delete The cancellation token. the amount of physically deleted entities Not supported for entities which are in a TargetPerEntity hierarchy.
This overload doesn't support Authorization or Auditing. It's recommended, if you want to use authorization and/or auditing on this method, use the overload of DeleteEntitiesDirectly which accepts a type.

Async variant of . Deletes all entities of the type passed in from the persistent storage if they match the filter supplied in filterBucket.

The type of the entity to retrieve persistence information. filter information to filter out the entities to delete the amount of physically deleted entities typeOfEntity;typeOfEntity can't be null Not supported for entities which are in a TargetPerEntity hierarchy.
This overload performs authorization. Use this overload instead of the one which accepts a name instead of a type instance if you want to have authorization support at runtime.

Async variant of . Deletes all entities of the type passed in from the persistent storage if they match the filter supplied in filterBucket.

The type of the entity to retrieve persistence information. filter information to filter out the entities to delete The cancellation token. the amount of physically deleted entities typeOfEntity;typeOfEntity can't be null Not supported for entities which are in a TargetPerEntity hierarchy.
This overload performs authorization. Use this overload instead of the one which accepts a name instead of a type instance if you want to have authorization support at runtime.

Entity object which contains the new values for the entities of the same type and which match the filter in filterBucket. Only fields which are changed are updated. filter information to filter out the entities to update. The cancellation token. the number of physically updated entities. Use this number only to test if the update succeeded (so value is > 0).

Async variant of . Saves the passed in entity to the persistent storage. Will not refetch the entity after this save. The entity will stay out-of-sync. If the entity is new, it will be inserted, if the entity is existent, the changed entity fields will be changed in the database. Will do a recursive save. Will pass the concurrency predicate returned by GetConcurrencyPredicate(ConcurrencyPredicateType.Save) as update restriction.

The entity to save true if the save was succesful, false otherwise. Will use a current transaction if a transaction is in progress

The entity to save The cancellation token. true if the save was succesful, false otherwise. Will use a current transaction if a transaction is in progress

Async variant of . Saves the passed in entity to the persistent storage. If the entity is new, it will be inserted, if the entity is existent, the changed entity fields will be changed in the database. Will do a recursive save. Will pass the concurrency predicate returned by GetConcurrencyPredicate(ConcurrencyPredicateType.Save) as update restriction.

The entity to save When true, it will refetch the entity from the persistent storage so it will be up-to-date after the save action. The cancellation token. true if the save was succesful, false otherwise. Will use a current transaction if a transaction is in progress

Async variant of . Saves the passed in entity to the persistent storage. If the entity is new, it will be inserted, if the entity is existent, the changed entity fields will be changed in the database. Will pass the concurrency predicate returned by GetConcurrencyPredicate(ConcurrencyPredicateType.Save) as update restriction.

The entity to save When true, it will refetch the entity from the persistent storage so it will be up-to-date after the save action. When true, it will save all dirty objects referenced (directly or indirectly) by entityToSave also. The cancellation token. true if the save was succesful, false otherwise. Will use a current transaction if a transaction is in progress

The entity to save When true, it will refetch the entity from the persistent storage so it will be up-to-date after the save action. Predicate expression, meant for concurrency checks in an Update query. Will be ignored if the entity is new. This predicate is used instead of a predicate produced by a set ConcurrencyPredicateFactory. When true, it will save all dirty objects referenced (directly or indirectly) by entityToSave also. The cancellation token. true if the save was succesful, false otherwise. Will use a current transaction if a transaction is in progress

Async variant of . Saves all dirty objects inside the collection passed to the persistent storage. It will do this inside a transaction if a transaction is not yet available. Will not refetch saved entities and will not recursively save the entities.

EntityCollection with one or more dirty entities which have to be persisted the amount of persisted entities

EntityCollection with one or more dirty entities which have to be persisted The cancellation token. the amount of persisted entities

Async variant of . Saves all dirty objects inside the collection passed to the persistent storage. It will do this inside a transaction if a transaction is not yet available.

EntityCollection with one or more dirty entities which have to be persisted the amount of physically deleted entities

EntityCollection with one or more dirty entities which have to be persisted The cancellation token. the amount of physically deleted entities

Async variant of . Deletes the specified entity from the persistent storage. The entity is not usable after this call, the state is set to OutOfSync. Will use the current transaction if a transaction is in progress. If the passed in entity has a concurrency predicate factory object, the returned predicate expression is used to restrict the delete process.

The entity instance to delete from the persistent storage true if the delete was succesful, otherwise false.

The entity instance to delete from the persistent storage The cancellation token. true if the delete was succesful, otherwise false.

Async variant of Executes the specified plain SQL query using this adapter. Every parameter value is converted into one or more parameters which have to be pre-defined in the sqlQuery

The type of the element to project each row to. The cancellation token. The SQL query to execute, which returns a resultset. Should contain parameter names for the parameter values, or placeholders for parameter sets. See documentation for details regarding format specifics. The object containing the parameter values to use in the query. If it's an object array, parameters using ordening are assumed, otherwise for each public, non-static property, a parameter is created. A list with 0 or more instances of T, one for each row in the resultset obtained from executing the query constructed from sqlQuery and the specified parameters

Async variant of Executes the passed in action query and, if not null, runs it inside the passed in transaction.

ActionQuery to execute. The cancellation token. execution result, which is the amount of rows affected (if applicable)

Async variant of . Executes the passed in retrieval query and, if not null, runs it inside the passed in transaction. Used to read 1 or more rows. It sets the connection object of the command object of query object passed in to the connection object of this class.

Async variant of . Executes the passed in retrieval query and returns the results in thedatatable specified using the passed in data-adapter. It sets the connection object of the command object of query object passed in to the connection object of this class.

Async variant of . Starts a new transaction. All database activity after this call will be ran in this transaction and all objects will participate in this transaction until its committed or rolled back. If there is a transaction in progress, an exception is thrown. Will create and open a new connection if a transaction is not open and/or available.

The isolation level to use for this transaction The name for this transaction The cancellation token. If a transaction is already in progress. If this DataAccessAdapter is in a System.Transactions.Transaction, no real ado.net transaction will be started, as a transaction is already in progress. In that situation, this method will just open the connection if required.

Async variant of . Opens the active connection object. If the connection is already open, nothing is done. If no connection object is present, a new one is created

DataAccessAdapterBase;This DataAccessAdapter instance has already been disposed, you can't use it for further persistence activity

Async variant of . Opens the active connection object. If the connection is already open, nothing is done. If no connection object is present, a new one is created

The cancellation token. DataAccessAdapterBase;This DataAccessAdapter instance has already been disposed, you can't use it for further persistence activity

Persists the queue passed in. The queue contains ActionQueueElements and is in the right order, just save it from front to back

Queue to persist. if true, the actions to perform are insert actions, otherwise update actions The cancellation token. the total amount of entities saved or -1 if the persist of the queue failed It assumes a transaction, if needed, is already created and opened, as well as a connection. All exceptions are bubbled upwards

The value projectors. The projector to use for projecting a plain row onto a new object provided by the projector. The query to execute. if set to true [perform value projections on plain row]. if set to true [post process database null values]. The type converters to use for the query. The key is the index in the result row, the value is the type converter to run on that value. These type converters have to run prior to the projectors will run. The cancellation token.

The destination to which instances of T will be added. The query to execute. The cancellation token. If true, the projection code used will perform implicit type conversions using a slower pipeline. If false, it will use optimized projection logic which assumes the value at ordinal n is of the expected type.

Merges the entities fetched in currentElement.RetrievalCollection with the rootEntities for a many to many relation

Current element. The parameters. Root entities. The cancellation token.

The value projectors. The projector to use for projecting a plain row onto a new object provided by the projector. The query to execute. The type converters to use for the query. The key is the index in the result row, the value is the type converter to run on that value. These type converters have to run prior to the projectors will run.

The value projectors. The projector to use for projecting a plain row onto a new object provided by the projector. The query to execute. if set to true the projection method will perform value projections on the plain row prior to using it in the projector and will create a new object row to store the projected values in. If false, the plain row is passed on as-is if set to true it will perform a DBNull to null conversion on the row passed to the projector. Only specify this to true if the projector deals with object arrays to the outside. In all other cases make the projectors already convert the DBNull values. The type converters to use for the query. The key is the index in the result row, the value is the type converter to run on that value. These type converters have to run prior to the projectors will run.

The destination to which instances of T will be added. The query to execute. If true, the projection code used will perform implicit type conversions using a slower pipeline. If false, it will use optimized projection logic which assumes the value at ordinal n is of the expected type.

Creates the stored procedure call command for the stored proc specified.

The stored procedure to call. array of parameters to pass ready to use DbCommand

Creates the correct stored procedure name, i.e. with catalog / schema name replaced properly.

The stored procedure to call.

Creates a new connection object using the current connection string value

Will close and dispose an active connection.

Returns the active connection object. If no connection object is present, a new one will be created.

The active connection object

Retrieves the persistence info for the field passed in.

FieldInfo which fieldpersistence info has to be retrieved the requested persistence information

Retrieves the persistence info objects for the fields of the entity passed in.

Entity object which fields the persistence information should be retrieved for the requested persistence information

Retrieves the persistence info objects for the fields of the entity passed in.

Entity name for entity type which fields the persistence information should be retrieved for the requested persistence information

Gets the DB provider factory instance.

ready to use Db provider factory instance

Gets the db specific creator instance for the database this object targets.

ready to use creator

Performs the execute single row retrieval query action. This method simply calls Execute on the queryToExecute passed in.

The query to execute. The commandbehavior to pass to Execute. live datareader created by the execute method Use this method to pass a different command behavior to queryToExecute.Execute(), which is necessary for ASE sybase for example, as the Sybase ASE provider has a critical issue in some versions where SingleRow doesn't work but SingleResult will

Creates a new physical connection object.

Connectionstring to use for the new connection object DbConnection implementing connection object.

Creates a new physical transaction object over the created connection. The connection is assumed to be open.

a physical transaction object, like an instance of SqlTransaction.

Creates a new .NET DataAdapter for the database system this DataAccessAdapter object is targeting.

New .NET DataAdapter object

Creates a new Dynamic Query engine object

Post-processes a new dynamic query engine object, which is passed in.

To process. the dqe passed in, post-processed and ready to be used.

Sets the per instance compatibility level on the dqe instance specified.

The dqe.

Method which is called from the default clause of the InsertPersistenceInfoObjects(predicateexpression) routine, which is useful for people who implement their own Predicate objects.

The current predicate object to fill the persistence info of.

Called right before the actual scalar query is executed

RetrievalQuery object which will be executed

Called right before the actual Save action is executed.

the ActionQuery object which will be executed the entity which will be saved by saveQuery

Called right after the actual Save action was executed.

the ActionQuery object which will be executed the entity which is saved by saveQuery

Called at the start of the SaveEntityCollection() method

the entity collection to save

Called at the end of the SaveEntityCollection() method

the entity collection which was saved

Called right before the actual delete action is executed

the ActionQuery object which will be executed the entity which will be deleted by deleteQuery

Called right before the actual delete action is executed

the ActionQuery object which will be executed the entity which was deleted by deleteQuery

Called at the start of the DeleteEntityCollection method

the entity collection to delete

Called at the end of the DeleteEntityCollection method

the entity collection which was delete

Called right before the actual delete query is executed

The ActionQuery to execute

Called right before the actual delete query is executed

The ActionQuery to execute

Called right before the actual fetch is executed.

the RetrievalQuery which will be executed the IEntityFields2 object which will be filled by selectQuery

Called right after the actual fetch is executed.

the RetrievalQuery which was executed the IEntityFields2 object which was filled by selectQuery

Called right before the actual fetch is executed

the RetrievalQuery which will be executed the entity collection to fill

Called right after the actual fetch is executed

the RetrievalQuery which was executed the entity collection which was filled

Called right before the actual fetch is executed

the RetrievalQuery object to execute the fieldslist used to construct the query the datatable object to fill

Called right after the actual fetch is executed

the RetrievalQuery object which was executed the fieldslist used to construct the query the datatable object which was filled

Called right before the actual fetch is executed

the RetrievalQuery object to execute the fieldslist used to construct the query the datatable object to fill

Called right after the actual fetch is executed

the RetrievalQuery object which was executed the fieldslist used to construct the query the datatable object which was filled

Called right before the actual update query is executed

The ActionQuery to execute

Called right after the actual update query is executed

The ActionQuery to execute

Called from PersistQueue, the internal queue processing routine, before the entity is validated and before the entity is used to create a query and actually saved. The entity passed in as entitySaved is already added to the transaction.

Entity to be saved. if true, the entity is in the insertqueue, otherwise the update queue. If not overriden calls the entity's OnBeforeEntitySave method.

Called right before the Commit() method starts its logic.

Called right after the Commit() method has performed its logic and the commit was succesful.

Called right before the Rollback() method starts its logic.

Called right after the Rollback() method has performed its logic and the rollback was succesful.

Inserts the persistence info objects on all objects referenced by the passed in field.

The field.

Inserts in the elements inside the specified windowspecification the persistence info.

Inserts in the elements inside the windowpartition specified the persistence info.

Inserts in each predicate expression element the persistence info object for the field used. If there is already a fieldpersistenceinfo element for a given field, it is skipped.

IPredicateExpression object which has predicate elements whose persistence info objects have to be set to a value.

Inserts in each entityrelation object the persistence info objects for the fields referenced.

IRelationCollection object which has entityrelation objects whose fields' persistence info objects have to be set to a value.

Inserts the persistence info objects into objects of the passed in tvfcall.

The TVF call.

Inserts the persistence info objects into the objects of the passed in derived table.

The derived table.

Inserts in each SortClause object the persistence info object for the field referenced.

ISortExpression object which has SortClause objects whose fields persistence info object has to be set to a value.

Inserts the persistence info objects into the function call object passed in, for every field object present as parameter in the function call.

The function call.

Inserts the persistence info objects into the scalar query expression object passed in.

The scalar query.

Inserts for each entityfield in the collection the persistence info object

IGroupByCollection object which has IEntityField(2) objects whose persistence info object has to be set to a value.

Inserts for each entityfield in the expression the persistence info object

IExpression object which has IEntityField(2) objects whose persistence info object has to be set to a value.

The core call of an action stored procedure call. Executes the command specified and opens the connection if required.

The command. the value returned by the ExecuteNonQuery call

The core call of a retrieval stored procedure call. Performs a fill operation on the adapter for the dataset specified

The data set to fill. The adapter.

The core call of a retrieval stored procedure call. Performs a fill operation on the adapter for the datatable specified

The data table to fill. The adapter.

Produces the func to create an action query from a set of action queries to be used for a packed query in a batch. By default this returns null so the default string compacter is used.

Creates a new insert DQ for the entity passed in.

the entity to create the Insert query for persistence objects for the entity a fully usable IActionQuery object

Creates a new Update DQ for the entity passed in.

the entity to create the Update query for persistence objects for the entity List, with for each entity (from root to leaf) the PK filter for that entity. a fully usable IActionQuery object

Creates a new Update DQ for the entity passed in.

the entity to with new values to use for the SET clauses persistence objects for the fields in entityWithNewValues List, with for each entity (from root to leaf) the PK filter for that entity. The additional filter to use in the update query, used for concurrency purposes Relations to walk to fulfill the filter a fully usable IActionQuery object

Creates a new Select DQ for the fields passed in using the parameters specified.

The parameters. ready to use query to use.

Creates a new RowCount DQ for the query build with the elements passed in

The parameters. ready to use query to use.

Creates a new Delete Query object which is ready to use.

Array of IFieldPersistenceInfo objects to use to build the delete query List, with for each entity (from root to leaf) the PK filter for that entity. IActionQuery instance which is ready to be used. Generic version When persistenceInfo is null

Creates a new Delete Query object which is ready to use.

Array of IFieldPersistenceInfo objects to use to build the delete query Arraylist, with for each entity (from root to leaf) the PK filter for that entity. Extra predicate for concurrency purposes. list of EntityRelation objects, which will be used to formulate a second FROM clause with INNER JOINs. IActionQuery instance which is ready to be used. Generic version When persistenceInfo is null or when deleteFilter is null or when relationsToWalk is null

Retrieves the persistence info for the fields passed in.

Fields for which the persistence info has to be determined the requested persistence information

The parameters. The cancellation token. BUG in call chain: QueryParameters passed in isn't a clone, while it's ordered to be altered. No entity factory specified in the passed in IEntityCollection2 object. Cannot continue;collectionToFill If the passed in collectionToFill doesn't contain an entity factory. Internal version. This version alters the filter inside parameters if the entity to fetch is in a hierarchy: it adds hierarchy relations to the filter passed. Calling methods should first clone the filter passed in before calling this method Async variant

Prepares the query for execution.

The query to execute. if set to true it will set the connection regardless if it is set The cancellation token. Async variant

The parameters. No entity factory specified in the passed in IEntityCollection2 object. Cannot continue;collectionToFill If the passed in collectionToFill doesn't contain an entity factory. Internal version. This version alters the filter inside parameters if the entity to fetch is in a hierarchy: it adds hierarchy relations to the filter passed. Calling methods should first clone the filter passed in before calling this method

Prepares the parameters specified for collection fetch.

The parameters. No entity factory specified in the passed in IEntityCollection2 object. Cannot continue;collectionToFill

Creates the action query from the SQL string and parameter values specified

Creates the retrieval query from the SQL string and parameter values specified, using the fetch aspects to configure the query and to add paging directives if necessary.

The fetch aspects. Can be null, in which case the defaults are used The SQL query to execute, which returns a resultset. Should contain parameter names for the parameter values, or placeholders for parameter sets. See documentation for details regarding format specifics. The object containing the parameter values to use in the query. If it's an object array, parameters using ordening are assumed, otherwise for each public, non-static property, a parameter is created.

Creates a retrieval query from elements.

The parameters. The select query.

Preprocesses the query elements which are to be used for constructing a query.

The parameters. Is adjusted by this method

The factory which will be used to create a new entity object which will be fetched the completely filled in IRelationPredicateBucket object which will be used as a filter for the fetch. The fetch will only load the first entity loaded, even if the filter results into more entities being fetched The context to add the entity to if the fetch was succesful. The list of IEntityField2 objects which have to be excluded or included for the fetch. If null or empty, all fields are fetched (default). If an instance of ExcludeIncludeFieldsList is passed in and its ExcludeContainedFields property is set to false, the fields contained in excludedIncludedFields are kept in the query, the rest of the fields in the query are excluded. The new entity fetched, or a previous entity fetched if that entity was in the context specified Internal version. This version alters filterBucket if the entity to fetch is in a hierarchy: it adds hierarchy relations to the filter passed. Calling methods should first clone the filter passed in before calling this method

Adds the passed in entity as a participant of this transaction. If KeepTrackOfTransactionParticipants is set to false, this method is a no-op.

The participant which actions have to be included in this transaction

Interprets the passed in filterbucket and returns information determined after interpreting the data inside the IRelationPredicateBucket object. The Relations and predicate expression are initialized with field persistence info objects

The IRelationPredicateBucket object with the filter information to interepret Ref parameter which will be true if there are relation objects specified inside filterBucket Ref parameter which will be the predicate expression to pass to query construction code

Fetches an entity from the persistent storage into the passed in Entity2 object using the filter specified.

The entity object in which the fetched entity data will be stored. The prefetch path to use for this fetch, which will fetch all related entities defined by the path as well. The context to add the entity to if the fetch was succesful, and before the prefetch path is fetched. This ensures that the prefetch path is fetched using the context specified and will re-use already loaded entity objects. The filter to use. The list of IEntityField2 objects which have to be excluded or included for the fetch. If null or empty, all fields are fetched (default). If an instance of ExcludeIncludeFieldsList is passed in and its ExcludeContainedFields property is set to false, the fields contained in excludedIncludedFields are kept in the query, the rest of the fields in the query are excluded. true if the Fetch was succesful, false otherwise Will use a current transaction if a transaction is in progress, so MVCC or other concurrency scheme used by the database can be utilized

Fetches an entity from the persistent storage using the filter specified.

The EntityFields2 object to store the entity data in the field persistence infos for the fields passed in.. The filter to use to retrieve one entity. If the filter matches more than 1 entity, the first entity read will be used. true if fetch succeeded, false otherwise

Removes all participating elements from this transaction and sends them a commit or rollback signal, based on the passed in boolean Commit. This action will make the participating objects to take care of their own connections again.

Action to perform on each removed element.

Resets the transaction object. All participants will be notified.

Fetches one row from the open data-reader and places that row into the passed in object rowDestination. rowDestination should match the format of the rows read by DataSource. Will only read the current row.

The open datareader used to fetch the data The IEntityFields2 implementing object where the data should be stored. The IFieldPersistenceInfo objects for the rowDestination fields

Merges the entities fetched in currentElement.RetrievalCollection with the rootEntities for a many to many relation

Current element. The parameters. Root entities.

Routine which is meant to handle value read errors when GetValues is called on the passed in reader. This routine is only called when the GetValues() method on the passed in reader throws an exception. Implementors of this routine thus have to call different methods to retrieve the values for the current row. The data has to be read into the toFill array.

The open datareader, positioned at the current active row array to fill with the current row's values The exception thrown by GetValues(toFill) true if the values are succesfully read, false otherwise. By default this routine returns false. If false is returned, ex is bubbled upwards by the caller.

Reads the value of the setting with the key SchemaNameUsageSetting from the *.config file and stores that value as the active setting for schemaNameUsageSetting for this instance, IF specified. If specified, a key with the name SchemaNameToUse is expected as well.

Schema name overwrites to fill.

Reads the value of the setting with the key CatalogNameUsageSetting from the *.config file and stores that value as the active setting for catalogNameUsageSetting for this instance, IF specified. If specified, a key with the name CatalogNameToUse is expected as well.

The catalog name overwrites.

Performs the second phase of the initialization. Done from derived classes.

The connection string. if set to [keep connection open]. The catalog name usage setting. The schema name usage setting. The catalog name to use. The schema name to use. The catalog name overwrites. The schema name overwrites.

Assures the connection is present.

Queues the auditor for audit entity flush at commit time. If no transaction is going on, it will flush the entities now in a separate transaction

The auditor.

Notifies the auditors that the transaction was committed. This means they should clean up any audit entities they contain.

Gathers the audit entities to save and then saves them in 1 go.

Disposes the postponed dispose candidates. Postponed dispose candidates are queries which couldn't be disposed when it was required and are disposed later on: when the connection is closed or when this adapter is disposed.

Creates the active connection and sets it in the query passed in if required.

The query to execute. if set to true it will set the connection regardless if it is set

Closes the connection if possible (i.e. when keepConnectionOpen is false and isTransactionInProgress is false

Prepares the query for execution.

The query to execute. if set to true it will set the connection regardless if it is set

Creates the conneciton and wires it to transaction and query.

The query to execute. if set to true [force connection set].

Prepares the restriction filter relations.

The entity. The restriction. The type of hierarchy. The pk filters. The relations.

Adds the queue elements to transaction.

The queue.

Creates the query for entity to save.

if set to true [insert actions]. The entity to save. The update restriction. The type of hierarchy. The persistence info objects.

Fetches the additional prefetch path for the entity fetched.

The prefetch path. The context to use. The fetched entity. The filter to use.

Gets the field persistence infos for the entity passed in.

The entity with new values. The type of hierarchy.

Inits the class.

The persistence info provider.

Raises the TransactionRolledback event.

Raises the TransactionCommitted event

Performs the start transaction post open tasks.

Performs the start transaction pre open tasks.

The isolation level to use for this transaction The name for this transaction

Performs the post entity save actions.

if set to true [insert actions]. The element. The entity to save. if set to true the query execution was successful and rows were affected. actions succeeded successfully, otherwise false During a save action an entity's update action failed. The entity which failed is enclosed.

Constructs the save query (insert or update) for the entity specified. It performs validation whether insert/update is allowed. Only if everything is OK and there's actually something to persist a query is created, otherwise this method returns null.

if set to true [insert actions]. The element. The entity to save. the query to execute, or null if there's no query to execute due to the entity not being dirty or because authorizers denied the action or the persistenceaction isn't in the entity's actioncombination defined on its mapping.

Creates the query for update entities directly.

The entity with new values. The filter bucket. Augmented by this function with hierarchy relations and persistenceinfo. Pass in a clone if this isn't desired.

Performs the post update entities directly actions.

The entity with new values. The filter bucket. The result. if set to true [transaction started locally].

Performs the post delete entities directly actions.

The filter bucket. To return. The dummy. if set to true [transaction started locally].

Creates the query for delete entities directly.

Name of the entity. The filter bucket.

Performs the post delete entity actions.

The entity to delete as entity base2. The delete restriction to use. if set to true [transaction started locally]. if set to true [delete succeeded]. The delete action of an entity failed, probably due to the set delete restriction. The entity which failed is enclosed.

Creates the query for delete entity.

The entity to delete. The delete restriction to use. The pk filters. the query to use, or null if no query has to be executed, or the query action isn't allowed.

Unwraps the active transaction (if present) and returns the real transaction.

Performs the pre save entity actions.

The entity to save. if set to true [refetch after save]. The update restriction. if set to true [recurse]. The insert queue. The update queue. if set to true [save keep connection open]. if set to true [transaction started in this scope]. if set to true [start transaction locally]. true if execution should proceed, false if there's nothing to do

Gets the active DynamicQueryEngine, in case of batching, or a new one which is then cached for the duration of the batch. If no batching is happening, a new DynamicQueryEngine is returned.

Preprocessing method for the parameters for a TypedView fetch in a datatable.

Commits the controlled ado.net transaction

Rolls back the controlled ado.net transaction

Async variant of . Fetches the excluded field batch defined by the parameters specified. The returned reader is used by the batch fetcher to merge the resultset it represents into the entities hold by the caller.

The result fields. The filter. Size of the batch. The cancellation token.

Creates the correct stored procedure name, i.e. with catalog / schema name replaced properly.

The stored procedure to call. the stored procedure name to use in a procedure call with schemas etc. properly replaced.

Fetches the excluded field batch defined by the parameters specified. The returned reader is used by the batch fetcher to merge the resultset it represents into the entities hold by the caller.

The result fields. The filter. Size of the batch.

Will notify all transaction participating entities that the transaction they're in, has been committed.

Will notify all transaction participating entities that the transaction they're in, has been rolled back.

Implements the IDispose' method Dispose.

Implements the Dispose functionality. If a transaction is in progress, it will rollback that transaction.

Flag which signals this routine if a dispose action should take place (true) or not (false)

Gets / sets the size of the batch command when performing multiple entity insert / update statements. If set to a value of 0, every entity insert / update statement will be executed using its own DbCommand. If set to a value of 2 or higher, insert / update statements are packed together into a single DbCommand, the number of packed statements is equal or lower than the value of BatchSize. Packed statements are queries with multiple SQL statements packed together in a single DbCommand. It's not recommended to set this property to a very high value, as databases process packed SQL statements slower than single commands and as parameter names are unique across the complete SQL string, re-using execution plans is not always possible. Set BatchSize to a value of 30 or lower for most operations; it's primarily used to mitigate network latency: the higher the network latency the higher BatchSize can become, to the point where processing the packed SQL string by the database is slower than the combined network latency of all single SQL statements.

Not all databases support packing multiple SQL statements into a single DbCommand. Please consult the LLBLGen Pro Runtime Framework user manual for a list of databases which support this feature. If the database used with this DataAccessAdapter doesn't support batching, setting this property has no effect, it will always be reset to 0, and all SQL statements are executed in their own DbCommand When set to a value of -1 or lower

Gets or sets the parameterised prefetch path threshold. This threshold is used to determine when the prefetch path logic should switch to a subquery or when it should use a WHERE field IN (value1, value2, ... valueN) construct, based on the # of elements in the parent collection. If that # of elements exceeds this threshold, a subquery is constructed, otherwise field IN (value1, value2, ...) construct is used. The default value is 50. On average, this is faster than using a subquery which returns 50 elements. Use this to tune prefetch path fetch logic for your particular needs.

This threshold is also used to determine if paging is possible. A page size bigger than this threshold will disable the paging functionality when using paging + prefetch paths.

Testing showed that values larger than 300 will be slower than a subquery.

Special thanks to Marcus Mac Innes (http://www.styledesign.biz) for this optimization code.

Gets IsTransactionInProgress. True when there is a transaction in progress.

Gets / sets the isolation level a transaction should use. Setting this during a transaction in progress has no effect on the current running transaction.

Gets the name of the transaction. Setting this during a transaction in progress has no effect on the current running transaction.

Gets / sets the connection string to use for the connection with the database.

Gets / sets KeepConnectionOpen, a flag used to keep open connections after a database action has finished.

The physical transaction object used over the current ActiveConnection.

Gets / sets the timeout value to use with the command object(s) created by the adapter. Default is 30 seconds Set this prior to calling a method which executes database logic.

Setting it to 0 won't have any effect: the commandtimeout is then not set. Set it to a value larger than 0.

Gets a value indicating whether a System.Transactions transaction is going on. If not, false is returned.

true if [in system transaction]; otherwise, false.

Gets the function mappings for the DQE related to this DataAccessAdapter. These function mappings are static and therefore not changeable.

Configurates this data access adapter object how to threat catalog names in persistence information.

For backwards compatibility.

The name to use if catalogNameUsageSetting is set to ForceName. Ignored otherwise.

For backwards compatibility.

The from-to name value pairs and setting for the overwriting of catalog names.

The from-to name value pairs and setting for the overwriting of schema names.

Gets or sets the active recovery strategy to use with supported actions on this DataAccessAdapter. If null (default), no recovery strategy is used and all exceptions are fatal.

The flag (default true) is used to signal the adapter that entities participating in a transaction controlled by this adapter are tracked during the transaction and which values are rolled back after a rollback of the transaction itself. Only set this flag to false if the entities participating in a transaction are not kept in memory during or after the transaction's life time.

Gets/sets the flag whether an active recovery strategy should be used. This property is true by default. If false, a query will executed outside the active recovery strategy set on this adapter.

General Entity Base class, which is used to inherit the Entity classes from. Used in the Adapter template set. This entity does not have any persistence info on board.

CTor

Private CTor for deserialization

Detaches this entity from all referencing entities and resets all references in this entity to other entities, including many-to-many relationships.

It can't reset references in other entities to this entity instance if this entity instance has no reference to said other entities, which means those references will still be present after calling this method. This method starts with this entity and dereferences itself from entities known by this entity.

Calls the create entity factory.

IEntityFactory2 instance created by the protected method CreateEntityFactory

Performs the after save actions.

if set to true the save was an insert, otherwise an update.

Gets a collection of related entities referenced by this entity which depend on this entity (this entity is the PK side of their FK fields). These entities will have to be persisted after this entity during a recursive save.

Enumerable with 0 or more IEntityCore objects, referenced by this entity

Gets a collection of related entities referenced by this entity which this entity depends on (this entity is the FK side of their PK fields). These entities will have to be persisted before this entity during a recursive save.

Enumerable with 0 or more IEntityCore objects, referenced by this entity

Gets a list of all entity collections stored as member variables in this entity. The contents of the list is used by the DataAccessAdapter to perform recursive saves. Only 1:n related collections are returned.

Enumerable with 0 or more IEntityCollectionCore objects, referenced by this entity

Creates a new entity factory instance related to this entity.

new IEntityFactoryCore implementing factory

Removes this instance from the parent collection (if present), to which it was added through databinding

Creates the factory.

Returns a new EntityCollection instance of the generated type for the specific entity type T

The entity type the collection is for

Creates a new RelationPredicateBucket with the predicates to filter on the related entities represented by the navigator specified.

Creates entity fields object for this entity. Used in constructor to setup this entity in a polymorphic scenario.

Calls the SetRelatedEntity method on the related entity specified during fast serialization. Used in 1:1 properties of generated entities in the deserialization branch of the setter.

The related entity. The navigator name related entity.

Sets the single related entity navigator to the value (toSet) specified. This isn't done directly, but indirecly by the opposite entity

To set. The navigator name in this.

ISerializable member. Does custom serialization so event handlers do not get serialized.

See ISerializable See ISerializable

Deserializes the member data of this instance.

Method which gets the member data for navigator members for binary serialization

Collection with 0 or more IEntityCollection2 objects, referenced by this entity

Collection with 0 or more IEntity2 objects, referenced by this entity

Calls the generic method CreateEntityCollectionForType, by creating a generic method call using the type specified. Caches the method info for future reference.

Creates a field compare value predicate for the field pair specified. Used with the creation of relation info objects in the generated code.

if true, use the pk field of the pair specified as the field to compare. if false, use the fk field of the pair for compare if true the pk field's index is used to obtain the value from this entity's fields, otherwise the fk field's index

Gets the serialization flags.

Bitvector with flags which control what's serialized.

Checks if the relation mapped by the property with the name specified is a one way / single sided relation. If the passed in name is null, it will return true if the entity has any single-sided relation

Name of the property which is mapped onto the relation to check, or null to check if the entity has any relation which is single sided true if the relation is single sided / one way (so the opposite relation isn't present), false otherwise

Method which restores owned data - i.e. considered private to this entity and not shared with any external object

The SerializationReader containing the serialized data The serialization flags (previously read)

Method which stores owned data - i.e. considered private to this entity and not shared with any external object

SerializationWriter The serialization flags (previously constructed)

Adds the member collections to the collections queue (base first)

The collections queue.

Gets the member collections queue from the queue (base first)

The collections queue.

Determines whether the entity has populated member collections

true if the entity has populated member collections.

Creates the member entity collections queue.

The collections queue. The required queue.

Gets the member entity collections internal.

Gets the created member entity collections internal.

The required flags.

Collection with 0 or more IEntity2 objects, referenced by this entity

Collection with 0 or more IEntityCollection2 objects, referenced by this entity

Returns a new ready to use factory for the type of this instance.

a new ready to use factory for the type of this instance.

List of IEntityField2 references which form the primary key. Reads/Affects .Fields.PrimaryKeyFields

Produces the actual XML for this entity, recursively. Because it recurses through referenced entities, it keeps track of which objects are processed so cyclic references are not resulting in cyclic recursion and thus a crash.

name of root element to use when building a complete XML representation of this entity. The writer to write the output to. Dictionary with ObjectIDs of all the objects already processed. If this entity's ObjectID is in the Dictionary's key list, a ProcessedObjectReference tag is emitted and the routine simply returns. The aspect flags to control the format of the XML produced if set to true, the start element produced is the absolute root element of the xml to produce. if set to true it will emit the entity type value in the root element as attribute.

Performs the actual conversion from Xml to entity data.

The reader to read the xml from. ObjectID's of all entities instantiated Arraylist with all the references to entity objects we probably do not yet have instantiated. This list is traversed after the xml tree has been processed. (not done by this routine, but by the caller)

Performs the actual conversion from Xml to entity data.

current node which points to an entity node. ObjectID's of all entities instantiated Arraylist with all the references to entity objects we probably do not yet have instantiated. This list is traversed after the xml tree has been processed. (not done by this routine, but by the caller)

Gets / sets parentCollection. databinding related.

EntityCollection implementation which is used for backwards compatibility and for design time databinding. This EntityCollectionNonGeneric is an EntityCollectionBase2(Of EntityBase2)

Initializes a new instance of the class.

CTor

The entity factory object to use when this collection has to construct new objects. This is the case when the collection is bound to a grid-like control for example.

Protected CTor for deserialization

Implementation of the entity collection base class.

CTor

The entity factory object to use when this collection has to construct new objects. This is the case when the collection is bound to a grid-like control for example.

CTor

initial contents for this collection

Private CTor for deserialization

Will add a new entity to the list, will set its parent collection property so CancelEdit will remove it from the list again, and will set its flag that it is added by databinding.

Do not call this method from your own code. This is a databinding ONLY method. If this collection is set to ReadOnly

Sets the entity information of the entity object containing this collection. Call this method only from entity classes which contain EntityCollection members, like 'Customer' which contains 'Orders' entity collection.

The entity containing this entity collection as a member variable The field the related entity has mapped onto the relation which delivers the entities contained in this collection

ISerializable member.

Creates a hierarchical projection of all the data in this collection and for each type in the complete graph found starting with each entity in this collection. Per entity type found, a new datatable is created inside destination or if one with the name of the entity is already present, that one is used. It will simply project every data element.

The destination dataset in which the projection result is stored. Each DataTable has the name of the entity contained, e.g. "CustomerEntity". DataRelations are created between the data if applicable. Data in destination's datatables (if present) is removed before a projection is performed.

Creates a hierarchical projection of all the data in this collection and for each type in the complete graph found starting with each entity in this collection, using the collectionProjections data passed in. Per entity type found, a new datatable is created inside destination or if one with the name of the entity is already present, that one is used.

The projection data per entity type The destination dataset in which the projection result is stored. Each DataTable has the name of the entity contained, e.g. "CustomerEntity". DataRelations are created between the data if applicable. Data in destination's datatables (if present) is removed before a projection is performed.

Creates a hierarchical projection of all the data in this collection and for each type in the complete graph found starting with each entity in this collection. Per entity type found, an entry is stored inside the destination dictionary. It will simply project every data element.

The destination dictionary in which the projection result is stored. destination is cleared before a projection is performed.

Creates a hierarchical projection of all the data in this view and for each type in the complete graph found starting with each entity in this view, using the viewProjections data passed in. Per entity type found, an entry is stored inside the destination dictionary.

The projection data per entity type The destination dictionary in which the projection result is stored. destination is cleared before a projection is performed.

Builds the collection projectors for this collection.

The collection projections. Type of the entities per.

Creates the hierarchical projection for the entities per type passed in into the destination specified.

The collection projections. The destination. Type of the entities per.

Creates the hierarchical projection for the entities per type passed in into the destination specified.

The collection projections. The destination. Type of the entities per.

Creates a new EntityView2 object of the right type on this collection with no filter nor sorter applied.

new EntityView2 on this collection

Creates a new EntityView2 object of the right type on this collection with the passed in filter applied

The filter. new EntityView2 on this collection

Creates a new EntityView2 object of the right type on this collection with the passed in filter and sorter applied to it.

The filter. The sorter. new EntityView2 on this collection

Creates a new EntityView2 object of the right type on this collection with the passed in filter and sorter applied to it and the dataChangeAction set to the passed in value.

The filter. The sorter. The data change action to take if data in the related collection changes. new EntityView2 on this collection

Sorts the collection.

Field to sort on the sort direction The comparer to use. If null, it will use the default comparer. For backwards compatibility.

Converts this entity collection to XML, recursively. Uses "EntityCollection" for the rootnode name

The complete outer XML as string, representing this complete entity object, including containing data.

Converts this entity collection to XML.

name of root element to use when building a complete XML representation of this entity collection. The complete outer XML as string, representing this complete entity object, including containing data.

Converts this entity collection to XML, recursively. Uses "EntityCollection" for the rootnode name

The aspect flags to control the format of the XML produced The complete outer XML as string, representing this complete entity object, including containing data.

Converts this entity collection to XML.

The aspect flags to control the format of the XML produced name of root element to use when building a complete XML representation of this entity collection. The complete outer XML as string, representing this complete entity object, including containing data.

Converts this entity collection to XML. Uses "EntityCollection" for the rootnode name

the XmlDocument which will contain the node this method will create. This document is required to create the new node object The XmlNode representing this complete entitycollection object, including containing data.

Converts this entity collection to XML.

Converts this entity collection to XML. Uses "EntityCollection" for the rootnode name

The aspect flags to control the format of the XML produced the XmlDocument which will contain the node this method will create. This document is required to create the new node object The XmlNode representing this complete entitycollection object, including containing data.

Converts this entity collection to XML.

The aspect flags to control the format of the XML produced name of root element to use when building a complete XML representation of this entity collection. the XmlDocument which will contain the node this method will create. This document is required to create the new node object The XmlNode representing this complete entitycollection object, including containing data.

Converts this entity collection to XML

The writer to write the output to. The aspect flags to control the format of the XML produced

Converts this entity collection to XML

The writer to write the output to. The aspect flags to control the format of the XML produced name of root element to use when building a complete XML representation of this entity collection.

Will fill the entity collection and its containing members (recursively) with the data stored in the XmlNode passed in. The XmlNode has to be filled with Xml in the format written by IEntityCollection2.WriteXml() and the Xml has to be compatible with the structure of this entity collection.

string with Xml data which should be read into this entity collection and its members. This string has to be in the correct format and should be loadable into a new XmlDocument without problems

XmlNode with Xml data which should be read into this entity collection and its members. Node's root element is the root element of the entity collection's Xml data

XmlNode with Xml data which should be read into this entity collection and its members. Node's root element is the root element of the entity collection's Xml data The format.

Constructs an object graph with this object as the root from the xml contained by the passed in XmlReader object.

Reader with xml used to produce an object graph

Constructs an object graph with this object as the root from the xml contained by the passed in XmlReader object.

The reader. The format the xml of the reader is in.

Produces the actual XML for this entity collection, recursively. Because it recurses through contained entities, it keeps track of which objects are processed so cyclic references are not resulting in cyclic recursion and thus a crash.

name of root element to use when building a complete XML representation of this entity collection. The writer to write the output to. Hashtable with ObjectIDs of all the objects already processed. If an entity's ObjectID is in the hashtable's key list, a ProcessedObjectReference tag is emitted and the entity will not recurse further. The aspect flags to control the format of the XML produced if set to true, the XML will contain the factory name, otherwise it won't. Used in Compact25 format if set to true, the start element produced is the absolute root element of the xml to produce.

Gets the entity collection description. This string is used in verbose trace messages. It will produce "EntityCollectionBase2", if the passed in switch flag is false, to prevent performance loss due to reflection activity for trace results which will never be seen.

switch flag. If this flag is false, "EntityCollectionBase2" will be returned

Performs the actual conversion from Xml to entity collection data.

The reader to read xml from. ObjectID's of all entities instantiated list with all the references to entity objects we probably do not yet have instantiated. This list is traversed after the xml tree has been processed. (not done by this routine, but by the caller) Assumes Compact25 formatted xml is present in the reader.

Performs the actual conversion from Xml to entity collection data.

current node which points to an entity collection node. ObjectID's of all entities instantiated list with all the references to entity objects we probably do not yet have instantiated. This list is traversed after the xml tree has been processed. (not done by this routine, but by the caller) Assumes Verbose or Compact formatted xml is present in the reader

Removes the passed in entity from the collection without notifying the entity to remove that it has been removed from this collection.

To remove.

Raises the list changed event, with the parameters passed in.

The index. The type of change.

Gets or sets a value indicating whether [surpress list changed events].

true if [surpress list changed events]; otherwise, false.

Resets the CachedPkHashes.

Gets / sets the DeserializationInProgress flag.

Gets the entity collection description. This string is used in verbose trace messages.

switch flag.

Creates a dummy instance using the entity factory stored in an inherited collection. This dummy instance is then used to produce property descriptors.

Dummy instance of entity contained in this collection, using the set factory.

name of root element to use when building a complete XML representation of this entity collection. the XmlDocument which will contain the node this method will create. This document is required to create the new node object Hashtable with ObjectIDs of all the objects already processed. If an entity's ObjectID is in the hashtable's key list, a ProcessedObjectReference tag is emitted and the entity will not recurse further. The aspect flags to control the format of the XML produced The XmlNode representing this complete entitycollection object, including containing data.

Performs the actual conversion from Xml to entity collection data.

Inserts an IEntityCore on position Index

Index where to insert the Object Entity Entity2 to insert

Performs the set related entity action on the passed in entity. This action is delegated to an inheritor.

The entity to perform the setrelated entity action on.

Performs the unset related entity action on the passed in entity. This action is delegated to an inheritor.

The entity to perform the unsetrelated entity action on.

Gets the entity description for the entity passed in.

The entity. if true, the method will produce TEntity.GetEntityDescription, otherwise it's a no-op

Creates the default entity view instance. By default it creates a new EntityView2(Of TEntity) instance, passing in this collection.

new entity view on this collection, to be used as the default entity view, returned by DefaultView

Determines the entity factory based on TEntity's value.

the entity factory to set

Inits the class

The EntityFactory2 to use when creating entity objects when a bound control is adding a new entity.

Inits the class.

The projection data per entity type The destination dataset in which the projection result is stored. Each DataTable has the name of the entity contained, e.g. "CustomerEntity". DataRelations are created between the data if applicable. destination is cleared before a projection is performed.

Creates a hierarchical projection of all the data in this collection and for each type in the complete graph found starting with each entity in this collection, using the collectionProjections data passed in. Per entity type found, an entry is stored inside the destination dictionary.

The projection data per entity type The destination dictionary in which the projection result is stored. destination is cleared before a projection is performed.

Adds an IEntity2 object to the list.

Entity2 to add Index in list

Adds the range of objects passed in. Objects have to be IEntity2 implementing objects

Collection to add

Inserts an IEntity2 on position Index

Index where to insert the Object Entity Entity2 to insert

Remove given IEntity2 instance from the list.

Entity2 object to remove from list.

Returns true if the list contains the given IEntity2 Object

Entity2 object to check. true if Entity2 exists in list.

Returns index in the list of given IEntity2 object.

Entity2 Object to check index in list.

copy the complete list of IEntity2 objects to an array of IEntity objects.

Array of IEntity2 Objects wherein the contents of the list will be copied. Start index to copy from

Creates a new EntityView2 object of the right type on this collection with no filter nor sorter applied.

new EntityView2 on this collection

Creates a new EntityView2 object of the right type on this collection with the passed in filter applied

The filter. new EntityView2 on this collection

Creates a new EntityView2 object of the right type on this collection with the passed in filter and sorter applied to it.

The filter. The sorter. new EntityView2 on this collection

Creates a new EntityView2 object of the right type on this collection with the passed in filter and sorter applied to it and the dataChangeAction set to the passed in value.

The filter. The sorter. The data change action to take if data in the related collection changes. new EntityView2 on this collection

Returns a readonly collection of entities which are flagged as dirty. This collection is determined on the fly, you can use this collection to remove dirty entities from this entity collection.

Gets or sets the at the specified index.

Gets the default view for this entitycollection. The returned value is a new instance every time this property is read. It's a new entity view without a filter or a sorter.

The default view.

Gets / sets the initial capacity of the entity collection.

Gets a value indicating whether the collection is a collection of objects.

true if the collection is a collection of objects; otherwise, false.

Returns an that can be bound to a data source from an object that does not implement an itself.

An that can be bound to a data source from the object.

Constructs the XML output from the object graph which has this object as the root.

Writer to which the xml is written to Uses XmlFormatAspect.Compact25 | XmlFormatAspect.MLTextInCDataBlocks | XmlFormatAspect.DatesInXmlDataType.

Produce the schema, always return null, as the XmlSerializer object otherwise can't handle our code.

Constructs an object graph with this object as the root from the xml contained by the passed in XmlReader object.

Reader with xml used to produce an object graph Uses XmlFormatAspect.Compact25 | XmlFormatAspect.MLTextInCDataBlocks | XmlFormatAspect.DatesInXmlDataType. Xml data should have been produced with WriteXml(writer) or a similar routine which is able to produce similar formatted XML

Gets the serialization flags.

If set to true, serialization flags are parsed If set to true, entity menber collections are included as well. Bitvector with the serialization flags

Method which restores owned data - i.e. considered private to this collection and not shared with any external object

SerializationWriter The serialization flags (previously constructed)

Method which restores owned data - i.e. considered private to this entity and not shared with any external object

The SerializationReader containing the serialized data The serialization flags (previously read)

Ares the entity types common.

Gets the serialization flags.

If set to true, serialization flags are parsed If set to true, entity menber collections are included as well. Bitvector with the serialization flags

Adds the specified entity.

The entity.

Inits the class

Gets or sets the containing entity mapped field

Lets the implementing class store internal data directly into a SerializationWriter.

The SerializationWriter to use Optional context to use as a hint as to what to store (BitVector32 is useful)

Lets the implementing class retrieve internal data directly from a SerializationReader.

The SerializationReader to use Optional context to use as a hint as to what to retrieve (BitVector32 is useful)

The EntityFactory2 to use when creating entity objects when bound to a grid and AddNew is enabled.

Returns true if this collection contains dirty objects. If this collection contains dirty objects, an already filled collection should not be refreshed until a save is performed. This property is calculated in real time and can be time consuming when the collection contains a lot of objects. Use this property only in cases when the value of this property is used to do a refetch or not.

Gets the default view for this entitycollection. The returned value is the same instance every time this property is read. It's an entity view without a filter or a sorter.

The default view.

Gets or sets the entity collection which should be used as removed entities tracker. If this property is set to an IEntityCollection2 instance, all entities which are removed from this collection are marked for deletion and placed in this removed entities tracker collection. This collection can then later on be used to delete these entities from the database in one go.

Gets the entity which contains this collection (e.g. Customer, if this collection is the Customer's Orders collection), or null if this collection isn't part of any entity.

Gets or sets the removal tracker internal.

Gets or sets the entity factory to use

Generic class which is used for the columns in the EntityFields collection, which forms the data store of any Entity class generated by LLBLGen Pro.

Initializes a new instance of the class, for deserialization purposes.

For deserialization purposes

CTor

The field info.

CTor

The field info. The containing entity fields core.

Initializes a new instance of the class.

Name The object alias. .NET Type of the data. Use this CTor for fields mapped onto a derived table with the alias objectAlias

Initializes a new instance of the class.

Name The object alias. .NET Type of the data. The maximum length of the field or 0 if not relevant The precision to use or 0 if not relevant. The scale to use or 0 if not relevant. Use this CTor for fields mapped onto a derived table with the alias objectAlias

Initializes a new instance of the class.

The name of the field. Has to be specified The expression to apply.

Initializes a new instance of the class.

The name of the field. Has to be specified The expression to apply. .NET Type of the data.

Initializes a new instance of the class.

The name of the field. Has to be specified The expression to apply. The aggregate function to apply.

Initializes a new instance of the class.

The name of the field. Has to be specified The expression to apply. The aggregate function to apply. .NET Type of the data.

Initializes a new instance of the class.

The name. The expression to apply. The aggregate function to apply. Type of the data. The object alias. The maximum length of the field or 0 if not relevant The precision to use or 0 if not relevant. The scale to use or 0 if not relevant.

Writes the XML of this Field object to the writer specified

The writer. The aspects.

Determines whether the specified is equal to the current .

The to compare with the current . true if the specified is equal to the current ; otherwise, false.

Overrides the GetHashCode() method. It will return the hashcode of the value of the field as the hashcode.

hashcode of the value of the field. byte[] typed fields will have all the bytes in their array added together with per byte it's multiplied with the index+1

Creates a deep copy of this IEntityField2 object

A deep copy of this object

Sets the entity field's ObjectAlias property to the specified value

value to set The entity field object the method was called on, for command chaining

Sets the field alias.

The field alias. The entity field object the method was called on, for command chaining

Sets the EntityField's AggregateFunctionToApply property

Function to apply. The entity field object the method was called on, for command chaining

Sets the Entity Field's ExpressionToToApply property

Expression to to apply. The entity field object the method was called on, for command chaining

Sets the entity field's OverClauseToApply property

the over clause to apply to the field the entity field object the method was called on, for command chaining

Operator overload for the '==' operator to produce a FieldCompareExpressionPredicate to represent leftOperand == rigthOperand

Left operand. Right operand. A FieldCompareExpressionPredicate

Operator overload for the '!=' operator to produce a FieldCompareExpressionPredicate to represent leftOperand != rigthOperand

Left operand. Right operand. A FieldCompareExpressionPredicate which is negated

Operator overload for the '>' operator to produce a FieldCompareExpressionPredicate to represent leftOperand > rigthOperand

Left operand. Right operand. A FieldCompareExpressionPredicate

Operator overload for the '>=' operator to produce a FieldCompareExpressionPredicate to represent leftOperand >= rigthOperand

Left operand. Right operand. A FieldCompareExpressionPredicate

Operator overload for the '<' operator to produce a FieldCompareExpressionPredicate to represent leftOperand < rigthOperand

Left operand. Right operand. A FieldCompareExpressionPredicate

Operator overload for the '<=' operator to produce a FieldCompareExpressionPredicate to represent leftOperand <= rigthOperand