/// <summary>
/// This method inserts a 'State' object.
/// This method uses the 'State_Insert' procedure.
/// </summary>
/// <returns>The identity value of the new record.</returns>
/// </summary>
public int InsertState(InsertStateStoredProcedure insertStateProc, DataConnector databaseConnector)
{
// Initial Value
int newIdentity = -1;
// Verify database connection is connected
if ((databaseConnector != null) && (databaseConnector.Connected))
{
// Execute Non Query
newIdentity = this.DataHelper.InsertRecord(insertStateProc, databaseConnector);
}
// return value
return(newIdentity);
}
/// <summary>
/// This method inserts a 'State' object.
/// </summary>
/// <param name='List<PolymorphicObject>'>The 'State' to insert.
/// <returns>A PolymorphicObject object with a Boolean value.
internal PolymorphicObject InsertState(List <PolymorphicObject> parameters, DataConnector dataConnector)
{
// Initial Value
PolymorphicObject returnObject = new PolymorphicObject();
// locals
State state = null;
// If the data connection is connected
if ((dataConnector != null) && (dataConnector.Connected == true))
{
// Create Insert StoredProcedure
InsertStateStoredProcedure insertStateProc = null;
// verify the first parameters is a(n) 'State'.
if (parameters[0].ObjectValue as State != null)
{
// Create State Parameter
state = (State)parameters[0].ObjectValue;
// verify state exists
if (state != null)
{
// Now create insertStateProc from StateWriter
// The DataWriter converts the 'State'
// to the SqlParameter[] array needed to insert a 'State'.
insertStateProc = StateWriter.CreateInsertStateStoredProcedure(state);
}
// Verify insertStateProc exists
if (insertStateProc != null)
{
// Execute Insert Stored Procedure
returnObject.IntegerValue = this.DataManager.StateManager.InsertState(insertStateProc, dataConnector);
}
}
else
{
// Raise Error Data Connection Not Available
throw new Exception("The database connection is not available.");
}
}
// return value
return(returnObject);
}
/// <summary>
/// This method creates an instance of an
/// 'InsertStateStoredProcedure' object and
/// creates the sql parameter[] array needed
/// to execute the procedure 'State_Insert'.
/// </summary>
/// <param name="state"The 'State' object to insert</param>
/// <returns>An instance of a 'InsertStateStoredProcedure' object.</returns>
public static InsertStateStoredProcedure CreateInsertStateStoredProcedure(State state)
{
// Initial Value
InsertStateStoredProcedure insertStateStoredProcedure = null;
// verify state exists
if (state != null)
{
// Instanciate insertStateStoredProcedure
insertStateStoredProcedure = new InsertStateStoredProcedure();
// Now create parameters for this procedure
insertStateStoredProcedure.Parameters = CreateInsertParameters(state);
}
// return value
return(insertStateStoredProcedure);
}
