Reflector

/*******************************************************************************************
 * Copyright (c) 2007 Alex ex machina
 *
 * Use of this software in any form requires that you have both 
 * read and agreed to the following terms:
 *
 * Permission is hereby granted, free of charge, to any person obtaining
 * a copy of this software and associated documentation files (the "Software"), 
 * to deal in the Software without restriction, including without limitation 
 * the rights to use, copy, modify, merge, publish, distribute, sublicense, 
 * and/or sell copies of the Software, and to permit persons to whom the
 * Software is furnished to do so, subject to the following conditions: 
 *
 * Redistributions of source code must retain the above copyright
 * notice, this list of conditions and the following disclaimer.
 * Redistributions in binary form must reproduce the above copyrightnotice, 
 * this list of conditions and the following disclaimer in the 
 * documentation and/or other materials provided with the distribution.
 * Neither the name of Nvigorate nor the names of its contributors may 
 * be used to endorse or promote products derived from this software without 
 * specific prior written permission. 
 *
 * THIS SOFTWARE IS PROVIDED "AS IS" AND ANY
 * EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
 * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE 
 * DISCLAIMED. IN NO EVENT SHALL ANY CONTRIBUTOR BE LIABLE FOR ANY
 * DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
 * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; 
 * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
 * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS 
 * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 * ****************************************************************************************/
 
using System;
using System.Reflection;
using System.Collections;
using System.Collections.Generic;
 
namespace Nvigorate.Reflection
{
 
    /// <summary>
    /// The Reflector class provides key functionality by simplifying commonly used
    /// reflection applications. This class is used extensively as it allows for dynamic,
    /// run-time defined manipulation of objects.
    /// This current version is designed to work with the 2.0 version of the .Net
    /// and Mono framework and has full support for generics.
    /// </summary>
    public partial class Reflector
    {
        #region Private Members
        private        static    BindingFlags    privFlag        = BindingFlags.Instance | BindingFlags.Public | BindingFlags.NonPublic;
        private        static    BindingFlags    pubFlag            = BindingFlags.Instance | BindingFlags.Public;
        private     static  BindingFlags    staticFlag      = BindingFlags.Static | BindingFlags.Public | BindingFlags.NonPublic | BindingFlags.FlattenHierarchy;
        private        static    BindingFlags    useFlag            = BindingFlags.Instance | BindingFlags.Public | BindingFlags.NonPublic;
 
        private        static    bool            recursive        = false;
        #endregion
 
        #region Properties
        /// <summary>
        /// Seting this flag to true to indicates that the Reflector will ignore private, 
        /// internal or protected class elements. A value of false indicates the Reflector
        /// will include private, internal class elements.
        /// </summary>
        public        static        bool            PublicOnly
        {
            get { return useFlag==pubFlag; }
            set { useFlag = (value) ? pubFlag : privFlag; }
        }
 
        /// <summary>
        /// Setting this flag true indicates that the Refelctor should include class elements
        /// contained in it's hierarchy (this is done recursively). Setting this flag false
        /// forces the Reflector to look only at class elements defined in the immediate type.
        /// </summary>
        public        static        bool            SearchHierarchy
        {
            get { return recursive; }
            set { recursive = value; }
        }
        #endregion