C:/Data/Projects/MCS EPM Global Practice/Frameworks/Public/mpfX/1.0/Libraries/Mcs.Epm.MicrosoftProject.mpFx/EnterpriseResource.cs

/*  ----------------------------------------------------------------------------
 *  Microsoft Corporation
 *  ----------------------------------------------------------------------------
 *  Microsoft Project Server mpFx (mpFx)
 *  ----------------------------------------------------------------------------
 *  Author: Colby Africa
 *  ----------------------------------------------------------------------------
 *  License: http://code.msdn.microsoft.com/mpFx/Project/License.aspx
 *  ----------------------------------------------------------------------------
 */

using System;
using System.Diagnostics;
using Mcs.Epm.MicrosoftProject.mpFx.ResourcesWebService;

namespace Mcs.Epm.MicrosoftProject.mpFx
{
    /// <summary>
    /// Wraps an enterprise resource
    /// </summary>
    public class EnterpriseResource
    {
        #region Instance Data

        private ResourceDataSet.ResourceCustomFieldsDataTable _CustomFields;
        private string _Filter;
        private string _LastUsedFilter;
        private ResourceDataSet.ResourcesRow _Resource;
        private ResourceCustomFieldsCollection _ResourceCustomFieldsCollection;

        #endregion

        #region Constructor

        /// <summary>
        /// Create an instance of EnterpriseResource
        /// </summary>
        /// <param name="parent">Parent collection object</param>
        /// <param name="resourceGuid">The GUID of the resource</param>
        /// <param name="name">The name of the resource</param>
        protected internal EnterpriseResource(ResourceCollection parent,
                                              Guid resourceGuid,
                                              string name)
        {
            if (parent == null)
            {
                throw new ArgumentNullException("parent");
            }

            if (resourceGuid == Guid.Empty)
            {
                throw new ArgumentException("resourceGuid");
            }

            if (string.IsNullOrEmpty(name))
            {
                throw new ArgumentException("name");
            }

            Parent = parent;
            Guid = resourceGuid;
            Name = name;
        }

        #endregion

        #region Public Properties

        public ResourceCollection Parent { get; private set; }

        public string Name { get; private set; }

        public Guid Guid { get; private set; }

        /// <summary>
        /// Retrieve standard information about the 
        /// </summary>
        public ResourceDataSet.ResourcesRow StandardInformation
        {
            get
            {
                // Check the resource and the filter.  If null, we need to load resource information.  If the last filter used is not the 
                // same as the current filter, reload the resource with the new filter.
                if (_Resource == null || _Filter != _LastUsedFilter)
                {
                    using (ResourceDataSet resourceDataSet = Parent.ResourcesWebService.ReadResources(_Filter, false))
                    {
                        Debug.Assert(resourceDataSet != null);

                        if (resourceDataSet.Resources.Rows.Count == 0)
                        {
                            throw new InvalidOperationException( /*  TODO: Exception Message */);
                        }

                        Debug.Assert(resourceDataSet.Resources.Rows.Count == 1);

                        _Resource = resourceDataSet.Resources.Rows[0] as ResourceDataSet.ResourcesRow;

                        Debug.Assert(_Resource != null);
                    }

                    _LastUsedFilter = _Filter;
                }

                return _Resource;
            }
        }

        /// <summary>
        /// Retrieve resource custom fields collection
        /// </summary>
        public ResourceCustomFieldsCollection CustomFields
        {
            get
            {
                if (_ResourceCustomFieldsCollection == null)
                {
                    _ResourceCustomFieldsCollection = new ResourceCustomFieldsCollection(this);
                }

                return _ResourceCustomFieldsCollection;
            }
        }

        /// <summary>
        /// Retrieve raw PSI resource custom fields dataset
        /// </summary>
        public ResourceDataSet.ResourceCustomFieldsDataTable CustomFieldsDataSet
        {
            get
            {
                if (_CustomFields == null)
                {
                    LoadResourceCustomFields();
                }

                return _CustomFields;
            }
        }

        #endregion

        #region Public Methods

        public void SetFilter(string filter)
        {
            if (filter != _Filter)
            {
                _Filter = filter;
            }
        }

        /// <summary>
        /// 
        /// </summary>
        public void LoadResourceCustomFields()
        {
            using (ResourceDataSet resourceDataSet = Parent.ResourcesWebService.ReadResource(Guid))
            {
                Debug.Assert(resourceDataSet != null);

                if (resourceDataSet.Resources.Rows.Count == 0)
                {
                    throw new InvalidOperationException( /*  TODO: Exception Message */);
                }

                Debug.Assert(resourceDataSet.Resources.Rows.Count == 1);

                _CustomFields = resourceDataSet.ResourceCustomFields;
            }
        }

        #endregion

        #region Internal Methods

        internal void Dispose()
        {
            if (_CustomFields != null)
            {
                _CustomFields.Dispose();
            }
        }

        #endregion
    }
}

---