Knight Data Access Layer
LoadOne(String,String,Dictionary<String,Object>) Method
Example 




KellermanSoftware.NetDataAccessLayer Namespace > IDataHelper Interface > LoadOne Method : LoadOne(String,String,Dictionary<String,Object>) Method
The database table name
A parameterized where clause
The parameters to use
Get a single record for a table and a parameterized where clause and return a dictionary.
Syntax
Overloads Function LoadOne( _
   ByVal tableName As String, _
   ByVal whereClause As String, _
   ByVal parameters As Dictionary(Of String,Object) _
) As Dictionary(Of String,Object)
Dim instance As IDataHelper
Dim tableName As String
Dim whereClause As String
Dim parameters As Dictionary(Of String,Object)
Dim value As Dictionary(Of String,Object)
 
value = instance.LoadOne(tableName, whereClause, parameters)

Parameters

tableName
The database table name
whereClause
A parameterized where clause
parameters
The parameters to use

Return Value

A dictionary of columns and values.
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==";
 
//Log to the console
db.EnableLogging();
 
//Open the database connection
db.OpenConnection();
 
//Create a new Person to save to the database
Person currentPerson = new Person();
currentPerson.FirstName = "John";
currentPerson.LastName = "Smith";
 
//Save it to the database 
db.Save(currentPerson);
 
string whereClause = "WHERE FirstName = @FirstName and LastName = @LastName";
 
Dictionary<string, object> parameters = new Dictionary<string, object>();
parameters.Add("FirstName", "John");
parameters.Add("LastName", "Smith");
 
Dictionary<string, object> list = db.LoadOne("Persons", whereClause, parameters);
 
Console.WriteLine(list.Count);
 
db.CloseConnection();
'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=="
 
'Log to the console
db.EnableLogging()
 
'Open the database connection
db.OpenConnection()
 
'Create a new Person to save to the database
Dim currentPerson As New Person()
currentPerson.FirstName = "John"
currentPerson.LastName = "Smith"
 
'Save it to the database 
db.Save(currentPerson)
 
Dim whereClause As String = "WHERE FirstName = @FirstName and LastName = @LastName"
 
Dim parameters As New Dictionary(Of String, Object)()
parameters.Add("FirstName", "John")
parameters.Add("LastName", "Smith")
 
Dim list As Dictionary(Of String, Object) = db.LoadOne("Persons", whereClause, parameters)
 
Console.WriteLine(list.Count)
 
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

See Also

Reference

IDataHelper Interface
IDataHelper Members
Overload List