DirectorySearcher.DerefAlias Property

Definition

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

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

C#
public System.DirectoryServices.DereferenceAlias DerefAlias { get; set; }
C#
[System.DirectoryServices.DSDescription("DSDerefAlias")]
[System.Runtime.InteropServices.ComVisible(false)]
public System.DirectoryServices.DereferenceAlias DerefAlias { get; set; }

Property Value

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

Attributes

Examples

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 = DereferenceAlias.Always;  
//Use the FindAll method to get search results.  
SearchResultCollection res = src.FindAll();  

Applies to

Tuote Versiot
.NET 8 (package-provided), 9 (package-provided), 10 (package-provided)
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0 (package-provided)
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9, 10

See also