linux-packaging-mono/mcs/class/System.DirectoryServices/System.DirectoryServices/SearchResult.cs

/******************************************************************************
* The MIT License
* Copyright (c) 2003 Novell Inc.,  www.novell.com
* 
* 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:
* 
* The above copyright notice and this permission notice shall be included in 
* all copies or substantial portions of the Software.
* 
* THE SOFTWARE IS PROVIDED AS IS, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR 
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, 
* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
* AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER 
* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
* OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
* SOFTWARE.
*******************************************************************************/

//
// System.DirectoryServices.SearchResult.cs
//
// Author:
//   Sunil Kumar (sunilk@novell.com)
//
// (C)  Novell Inc.
//

using System.ComponentModel;
using Novell.Directory.Ldap;
using System.Collections.Specialized;

namespace System.DirectoryServices
{
	
	/// <summary>
	///Encapsulates a node or object in the Ldap Directory hierarchy.
	/// </summary>
    public class SearchResult
	{

		private string _Path=null;
		private ResultPropertyCollection _Properties=null;
		private DirectoryEntry _Entry=null;
		private StringCollection _PropsToLoad=null;
		private bool ispropnull=true;
		private PropertyCollection _Rproperties = null;

		internal PropertyCollection Rproperties
		{
			get
			{
				return _Rproperties;
			}
		}

		private void InitBlock()
		{
			_Properties=null;
			_Entry=null;
			_PropsToLoad=null;
			ispropnull=true;
			_Rproperties=null;
		}

		internal StringCollection PropsToLoad
		{
			get
			{
				if( _PropsToLoad != null )
				{
					return _PropsToLoad;
				}
				else
					return null;
			}
		}
		/// <summary>
		/// Gets a ResultPropertyCollection of properties set on this object.
		/// </summary>
		/// <value>
		/// A ResultPropertyCollection of properties set on this object.
		/// </value>
		/// <remarks>
		/// This collection only contains properties that were explicitly 
		/// requested through DirectorySearcher.PropertiesToLoad.
		/// </remarks>
		public ResultPropertyCollection Properties
		{
			get
			{
				if ( ispropnull )
				{
					_Properties= new ResultPropertyCollection();
					System.Collections.IDictionaryEnumerator id = 
						Rproperties.GetEnumerator();
//						_Entry.Properties.GetEnumerator();
					while(id.MoveNext())
					{
						string attribute=(string)id.Key;
							ResultPropertyValueCollection rpVal=
								new ResultPropertyValueCollection();
							if(Rproperties[attribute].Count==1)
							{
								String val = (String)Rproperties[attribute].Value;
								rpVal.Add(val);
							}
							else if (Rproperties[attribute].Count > 1)
							{
								Object[] vals=(Object [])Rproperties[attribute].Value;
//								String[] aStrVals= new String[_Entry.Properties[attribute].Count];
								rpVal.AddRange(vals);
							}
							_Properties.Add(attribute,rpVal);
					}
					ispropnull=false;
				}
				return _Properties;
			}
		}

		internal SearchResult(DirectoryEntry entry)
		{
			InitBlock();
			_Entry = entry;
			_Path = entry.Path;
		}

		internal SearchResult(DirectoryEntry entry, PropertyCollection props)
		{
			InitBlock();
			_Entry = entry;
			_Path = entry.Path;
			_Rproperties = props;
		}
		/// <summary>
		/// Gets the path for this SearchResult.
		/// </summary>
		/// <value>
		/// The path of this SearchResult.
		/// </value>
		/// <remarks>
		/// The Path property uniquely identifies this entry in the Active 
		/// Directory hierarchy. The entry can always be retrieved using this 
		/// path
		/// </remarks>
		public string Path 
		{
			get
			{
				return _Path;
			}
		}

		/// <summary>
		/// Retrieves the DirectoryEntry that corresponds to the SearchResult, 
		/// from the Active Directory hierarchy.
		/// </summary>
		/// <returns>
		/// The DirectoryEntry that corresponds to the SearchResult
		/// </returns>
		/// <remarks>
		/// Use GetDirectoryEntry when you want to look at the live entry 
		/// instead of the entry returned through DirectorySearcher, or when 
		/// you want to invoke a method on the object that was returned.
		/// </remarks>
		public DirectoryEntry GetDirectoryEntry()
		{
			return _Entry;
		}

	}
}