QueryAll
This method is used to query all the rows from the table.
Code Snippets
Below is the sample code to fetch a row from the [dbo].[Person] table.
using (var connection = new SqlConnection(connectionString)) { var people = connection.QueryAll<Person>(); } Targeting a Table
You can also target a specific table by passing the literal table like below.
using (var connection = new SqlConnection(connectionString)) { var people = connection.QueryAll<Person>("[dbo].[Person]"); } Or via dynamics.
using (var connection = new SqlConnection(connectionString)) { var people = connection.QueryAll("[dbo].[Person]"); } The result is a list of dynamic objects of type ExpandoObject.
Specific Columns
You can also target a specific columns to be queried by passing the list of fields to be included in the fields argument.
using (var connection = new SqlConnection(connectionString)) { var fields = Field.Parse<Person>(e => new { e.Id, e.Name, e.DateOfBirth, e.DateInsertedUtc }); var people = connection.QueryAll<Person>(fields: fields); } Or via dynamics.
using (var connection = new SqlConnection(connectionString)) { var people = connection.Query("[dbo].[Person]", fields: Field.From("Id", "Name", "DateOfBirth", "DateInsertedUtc")); } Type Result
You can also directly target a string column as a result set.
using (var connection = new SqlConnection(connectionString)) { var names = connection.QueryAll<string>(ClassMappedNameCache.Get<Person>(), fields: Field.From(nameof(Person.Name))).FirstOrDefault(); } Inferrence works in all types but not from this operation. The other non-class type (i.e.: long, int, System.DateTime, etc) cannot be inferred as the TEntity generic type is filtered as class. Please see the ExecuteQuery operation for the support to the other types.
Table Hints
To pass a hint, simply write the table-hints and pass it in the hints argument.
using (var connection = new SqlConnection(connectionString)) { var people = connection.QueryAll<Person>(hints: "WITH (NOLOCK)"); } Or, you can use the SqlServerTableHints class.
using (var connection = new SqlConnection(connectionString)) { var people = connection.QueryAll<Person>(hints: SqlServerTableHints.TabLock); } Ordering the Results
To order the results, you have to pass an array of OrderField objects in the orderBy argument.
using (var connection = new SqlConnection(connectionString)) { var orderBy = OrderField.Parse(new { LastName = Order.Descending, FirstName = Order.Ascending }); var people = connection.QueryAll<Person>(orderBy: orderBy); // Do the stuffs for 'people' here } Caching the Results
To cache the results, simply pass a literal string key into the cacheKey argument.
using (var connection = new SqlConnection(connectionString)) { var people = connection.QueryAll<Person>(cacheKey: "CackeKey:AllPeople"); // Do the stuffs for 'people' here } The cache expiration is defaulted to 180 minutes. You can override it by passing an integer value at the
cacheExpirationInMinutesargument.