/// <summary>
        /// The object factory for a particular data collection instance.
        /// </summary>
        public virtual void CreateObjectsFromData(ContactPointCollection contactpointcollection, System.Data.SqlClient.SqlDataReader data)
        {
            // Do nothing if we have nothing
            if (data == null) return;

            // Create a local variable for the new instance.
            ContactPoint newobj = null;
            // Iterate through the data reader
            while (data.Read())
            {
                // Create a new object instance
                newobj = System.Activator.CreateInstance(contactpointcollection.ContainsType[0]) as ContactPoint;
                // Let the instance set its own members
                newobj.SetMembers(ref data);
                // Add the new object to the collection instance
                contactpointcollection.Add(newobj);
            }
        }
        /// <summary>
        /// The object factory for a particular data collection instance.
        /// </summary>
        public virtual void CreateObjectsFromData(ContactPointCollection contactpointcollection, System.Data.DataSet data)
        {
            // Do nothing if we have nothing
            if (data == null || data.Tables.Count == 0 || data.Tables[0].Rows.Count == 0) return;

            // Create a local variable for the new instance.
            ContactPoint newobj = null;
            // Create a local variable for the data row instance.
            System.Data.DataRow dr = null;

            // Iterate through the table rows
            for (int i = 0; i<data.Tables[0].Rows.Count; i++)
            {
                // Get a reference to the data row
                dr = data.Tables[0].Rows[i];
                // Create a new object instance
                newobj = System.Activator.CreateInstance(contactpointcollection.ContainsType[0]) as ContactPoint;
                // Let the instance set its own members
                newobj.SetMembers(ref dr);
                // Add the new object to the collection instance
                contactpointcollection.Add(newobj);
            }
        }
        /// <summary>
        /// Gets the objects for the CONTACT_POINT relationship.
        /// </summary>
        public ContactPointCollection GetContactPointCollection()
        {
            ContactPointCollection contactpointcollection = new ContactPointCollection();

            ContactPointBase.ServiceObject.FillByContactPointRoleType(contactpointcollection, _id);
            return contactpointcollection;
        }
        /// <summary>
        /// Gets all the available objects.
        /// </summary>
        public virtual ContactPointCollection GetAll()
        {
            // create a new instance of the return object
            ContactPointCollection objects = new ContactPointCollection();

            // fill the objects
            this.Fill(objects);

            // return the filled object from the service
            return objects;
        }
        /// <summary>
        /// Fill method for populating a collection by ContactPointType
        /// </summary>
        public void FillByContactPointType(ContactPointCollection contactPointCollection, System.Int16 id)
        {
            // create the connection to use
            SqlConnection cnn = new SqlConnection(ContactPoint.GetConnectionString());

            try
            {
                // discover the sql parameters
                SqlParameterHash sqlparams = SqlHelperParameterCache.GetSpParameterSet(ContactPoint.GetConnectionString(), "gsp_SelectContactPointCollectionByContactPointType");

                using (cnn)
                {
                    // open the connection
                    cnn.Open();

                    // set the parameters
                    sqlparams["@type"].Value = id;

                    // create an instance of the reader to fill.
                    SqlDataReader datareader = SqlHelper.ExecuteReader(cnn, "gsp_SelectContactPointCollectionByContactPointType", sqlparams);

                    // Send the collection and data to the object factory.
                    CreateObjectsFromData(contactPointCollection, datareader);

                    // close the connection
                    cnn.Close();
                }

                // nullify the connection
                cnn = null;
            }
            catch (SqlException sqlex)
            {
                throw sqlex;
            }
        }
        /// <summary>
        /// Fill method for populating an entire collection of ContactPointCollection
        /// </summary>
        public virtual void Fill(ContactPointCollection contactPointCollection)
        {
            // create the connection to use
            SqlConnection cnn = new SqlConnection(ContactPoint.GetConnectionString());

            try
            {
                using (cnn)
                {
                    // open the connection
                    cnn.Open();

                    // create an instance of the reader to fill.
                    SqlDataReader datareader = SqlHelper.ExecuteReader(cnn, "gsp_SelectContactPointCollection");

                    // Send the collection and data to the object factory
                    CreateObjectsFromData(contactPointCollection, datareader);

                    // close the connection
                    cnn.Close();
                }

                // nullify the connection
                cnn = null;
            }
            catch (SqlException sqlex)
            {
                throw sqlex;
            }
        }