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