/// <summary>
/// This method inserts a 'UIField' object.
/// This method uses the 'UIField_Insert' procedure.
/// </summary>
/// <returns>The identity value of the new record.</returns>
/// </summary>
public int InsertUIField(InsertUIFieldStoredProcedure insertUIFieldProc, DataConnector databaseConnector)
{
// Initial Value
int newIdentity = -1;
// Verify database connection is connected
if ((databaseConnector != null) && (databaseConnector.Connected))
{
// Execute Non Query
newIdentity = this.DataHelper.InsertRecord(insertUIFieldProc, databaseConnector);
}
// return value
return(newIdentity);
}
/// <summary>
/// This method inserts a 'UIField' object.
/// </summary>
/// <param name='List<PolymorphicObject>'>The 'UIField' to insert.
/// <returns>A PolymorphicObject object with a Boolean value.
internal PolymorphicObject InsertUIField(List <PolymorphicObject> parameters, DataConnector dataConnector)
{
// Initial Value
PolymorphicObject returnObject = new PolymorphicObject();
// locals
UIField uIField = null;
// If the data connection is connected
if ((dataConnector != null) && (dataConnector.Connected == true))
{
// Create Insert StoredProcedure
InsertUIFieldStoredProcedure insertUIFieldProc = null;
// verify the first parameters is a(n) 'UIField'.
if (parameters[0].ObjectValue as UIField != null)
{
// Create UIField Parameter
uIField = (UIField)parameters[0].ObjectValue;
// verify uIField exists
if (uIField != null)
{
// Now create insertUIFieldProc from UIFieldWriter
// The DataWriter converts the 'UIField'
// to the SqlParameter[] array needed to insert a 'UIField'.
insertUIFieldProc = UIFieldWriter.CreateInsertUIFieldStoredProcedure(uIField);
}
// Verify insertUIFieldProc exists
if (insertUIFieldProc != null)
{
// Execute Insert Stored Procedure
returnObject.IntegerValue = this.DataManager.UIFieldManager.InsertUIField(insertUIFieldProc, 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
/// 'InsertUIFieldStoredProcedure' object and
/// creates the sql parameter[] array needed
/// to execute the procedure 'UIField_Insert'.
/// </summary>
/// <param name="uIField"The 'UIField' object to insert</param>
/// <returns>An instance of a 'InsertUIFieldStoredProcedure' object.</returns>
public static InsertUIFieldStoredProcedure CreateInsertUIFieldStoredProcedure(UIField uIField)
{
// Initial Value
InsertUIFieldStoredProcedure insertUIFieldStoredProcedure = null;
// verify uIField exists
if (uIField != null)
{
// Instanciate insertUIFieldStoredProcedure
insertUIFieldStoredProcedure = new InsertUIFieldStoredProcedure();
// Now create parameters for this procedure
insertUIFieldStoredProcedure.Parameters = CreateInsertParameters(uIField);
}
// return value
return(insertUIFieldStoredProcedure);
}
