This documentation is archived and is not being maintained.

DirectorySearcher.DerefAlias Property

Gets or sets a value indicating how the aliases of objects that are found during a search should be resolved.

Namespace: System.DirectoryServices
Assembly: System.DirectoryServices (in system.directoryservices.dll)

public DereferenceAlias DerefAlias { get; set; }
/** @property */
public DereferenceAlias get_DerefAlias ()

/** @property */
public void set_DerefAlias (DereferenceAlias value)

public function get DerefAlias () : DereferenceAlias

public function set DerefAlias (value : DereferenceAlias)

Not applicable.

Property Value

A DereferenceAlias value that specifies the behavior in which aliases are dereferenced. The default setting for this property is Never.

The following C# example shows how to set the DerefAlias property to Always , so that it dereferences aliases when both searching subordinates and locating base objects.

using System.DirectoryServices;
// Bind to the users container.
DirectoryEntry entry = new DirectoryEntry("LDAP://CN=users,DC=fabrikam,DC=com");
// Create a DirectorySearcher object.
DirectorySearcher mySearcher = new DirectorySearcher(entry);
// Set DerefAlias to Always.
src.DerefAlias = DerefenceAlias.Always;
//Use the FindAll method to get search results.
SearchResultCollection res = src.FindAll();

Windows 98, Windows Server 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0