Session.GetObjectsFromQuery<T>(LoadDataMemberOrderItem, String) Method
Executes a SQL query and returns its result set as a collection of objects of a non-persistent type specified by the generic type parameter.
public ICollection<T> GetObjectsFromQuery<T>( LoadDataMemberOrderItem members, string sql )
Public Function GetObjectsFromQuery(Of T)( members As LoadDataMemberOrderItem(), sql As String ) As ICollection(Of T)
An array of LoadDataMemberOrderItem objects which provide mapping information for object members and the query's result set columns.
A String value that specifies a SQL query.
A collection of non-persistent objects of the specified type that are instantiated with data obtained via the specified SQL query.
This method performs the following:
- Executes the specified SQL query and obtains the query result as a result set.
- Creates objects of the specified type and instantiates them with the result set's data, based on the mapping information passed as the members parameter. Note that the GetObjectsFromQuery<T> method's generic type parameter should specify a non-persistent class decorated with a NonPersistentAttribute.
- Populates a collection with these objects.
The GetObjectsFromQuery<T> method throws an exception if the members array includes any of the following:
- A property that is not defined within the T type.
- A struct type member.
- A reference to a class with a struct type member.
- A collection used in object relations.
To learn more about executing SQL queries in XPO and retrieving objects from query results, refer to Direct SQL Queries.