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)

[ComVisibleAttribute(false)]
[DSDescriptionAttribute("DSDerefAlias")]
public DereferenceAlias DerefAlias { get; set; }

Property Value

Type: System.DirectoryServices.DereferenceAlias
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();

.NET Framework

Supported in: 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
Show: