LoadPage<T>(String,IEnumerable<Object>,String,Int32,Int32) Method

Load a page of records that are filtered by a where clause and ordered

Syntax

Visual Basic (Declaration)
Visual Basic (Usage)
C#
Managed Extensions for C++
C++/CLI

Public Overloads Function LoadPage(Of T As {Class, New})( _
   ByVal whereClause As String, _
   ByVal nameValueParameters As IEnumerable(Of Object), _
   ByVal orderBy As String, _
   ByVal page As Integer, _
   ByVal pageSize As Integer _
) As List(Of T)

Dim instance As DataHelper
Dim whereClause As String
Dim nameValueParameters As IEnumerable(Of Object)
Dim orderBy As String
Dim page As Integer
Dim pageSize As Integer
Dim value As List(Of T)
 
value = instance.LoadPage(Of T)(whereClause, nameValueParameters, orderBy, page, pageSize)

public List<T> LoadPage<T>( 
   string whereClause,
   IEnumerable<object> nameValueParameters,
   string orderBy,
   int page,
   int pageSize
)
where T: class, new()

public: List<T*>* LoadPage<T>( 
   string* whereClause,
   IEnumerable<Object*>* nameValueParameters,
   string* orderBy,
   int page,
   int pageSize
) 
where T: ref class, gcnew()

public:
List<T^>^ LoadPagegeneric<typename T>
( 
   String^ whereClause,
   IEnumerable<Object^>^ nameValueParameters,
   String^ orderBy,
   int page,
   int pageSize
) 
where T: ref class, gcnew()

Parameters

whereClause: A SQL where clause
nameValueParameters: The parameters to use for the where clause
orderBy: Order by SQL Clause
page: Page of records starting at 1
pageSize: The number of records to get per page

Type Parameters

T: Generic class type

Example

//Get the current thread static safe instance of the helper
IDataHelper db = DataHelper.SessionFactory();
 
//Specify User Name and License Key from the receipt, leave blank for trial mode
//db.UserName = "John Smith 1234";
//db.LicenseKey = "asdfl219==";
 
// Open the database connection
db.OpenConnection();
 
// Clear table Person
db.TruncateTable("Person");
 
// Create Persons to save to the database
List<Person> persons = new List<Person>
                           {
                               new Person
                                   {
                                       FirstName = "Han",
                                       LastName = "Solo"
                                   },
                               new Person
                                   {
                                       FirstName = "Luke",
                                       LastName = "Skywalker"
                                   },
                               new Person
                                   {
                                       FirstName = "Leia",
                                       LastName = "Organa"
                                   },
                               new Person
                                   {
                                       FirstName = "Obi-Wan",
                                       LastName = "Kenobi"
                                   },
                               new Person
                                   {
                                       FirstName = "Padme",
                                       LastName = "Amidala"
                                   },
                           };
 
// Save them to the database 
db.Save(persons);
 
var result = db.LoadPage<Person>("WHERE LastName <> @LastName",
                                  new object[] {"FirstName", "Han" },
                                  "ORDER BY FirstName",
                                  2,
                                  2);
 
result = db.LoadPage<Person>("FirstName <> @FirstName",
                              new Dictionary<string, object>
                                  {
                                      { "@FirstName", "Han" }
                                  },
                              "LastName",
                              2,
                              2);
 
// Close the connection
db.CloseConnection();

VB.NET

'Get the current thread static safe instance of the helper
Dim db As IDataHelper = DataHelper.SessionFactory()
 
'Specify User Name and License Key from the receipt, leave blank for trial mode
'db.UserName = "John Smith 1234"
'db.LicenseKey = "asdfl219=="
 
' Open the database connection
db.OpenConnection()
 
' Clear table Person
db.TruncateTable("Person")
 
' Create Persons to save to the database
Dim persons As New List(Of Person)() From {
    New Person With {.FirstName = "Han", .LastName = "Solo"},
    New Person With {.FirstName = "Luke", .LastName = "Skywalker"},
    New Person With {.FirstName = "Leia", .LastName = "Organa"},
    New Person With {.FirstName = "Obi-Wan", .LastName = "Kenobi"},
    New Person With {.FirstName = "Padme", .LastName = "Amidala"}}
 
' Save them to the database 
db.Save(persons)
 
Dim result = db.LoadPage(Of Person)("WHERE LastName <> @LastName", New Dictionary(Of String, Object) From {{ "@LastName", "Organa" }}, "ORDER BY FirstName", 2, 2)
 
result = db.LoadPage(Of Person)("FirstName <> @FirstName", new object[] {"FirstName", "Han" }, "LastName", 2, 2)
 
' Close the connection
db.CloseConnection()

Requirements

Target Platforms: Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

Reference

DataHelper Class
DataHelper Members
Overload List