// fetch by Primary key into new class instance
// links:
// crud definition: https://en.wikipedia.org/wiki/Create,_read,_update_and_delete
// docLink: http://sql2x.org/documentationLink/7a625d0a-3028-42ce-a543-72ea3673cef4
// parameters:
// defaultStateRcd: primary key of table default_state_ref
public static CrudeDefaultStateRefData GetByDefaultStateRcd(string defaultStateRcd)
{
// create query against default_state_ref
// this will be ansi sql and parameterized
// parameterized queries are a good way of preventing sql injection
// and to make sure the query plan is pre-compiled
// links:
// docLink: http://sql2x.org/documentationLink/72f5fc83-c460-40fe-bac9-73b7ee0c6b77
string sql = @" select top 1 default_state_rcd, default_state_name, default_user_id, date_time
from [default_state_ref]
where default_state_rcd = @default_state_rcd
order by default_state_name";
var ret = new CrudeDefaultStateRefData();
// open standard connection
// the connection is found in web.config
// the connection is closed upon completion of the reader
// links:
// docLink: http://sql2x.org/documentationLink/1ecca728-0c07-4dd7-b095-d10777b25b70
using (var conn = new SqlConnection(Conn.ConnectionString)) {
conn.Open();
using (var command = new SqlCommand(sql, conn)) {
// add primary key
// this primary key will be used together with the prepared ansi sql statement
// links:
// docLink: http://sql2x.org/documentationLink/1ecca728-0c07-4dd7-b095-d10777b25b70
command.Parameters.Add("@default_state_rcd", SqlDbType.NVarChar).Value = defaultStateRcd;
// execute query against default_state_ref
// if the query fails in the preprocessor of sql server
// an exception will be raised
// links:
// docLink: http://sql2x.org/documentationLink/fd5c5faa-b400-4f29-b12b-9675c53a757f
IDataReader reader = command.ExecuteReader(CommandBehavior.SingleRow);
// populate serialized class if a row was found
if (reader.Read())
{
ret.Populate(reader);
}
}
}
return(ret);
}