This documentation is archived and is not being maintained.

DirectorySearcher.ReferralChasing Property

Gets or sets how referrals are chased.

[Visual Basic]
Public Property ReferralChasing As ReferralChasingOption
public ReferralChasingOption ReferralChasing {get; set;}
public: __property ReferralChasingOption get_ReferralChasing();
public: __property void set_ReferralChasing(ReferralChasingOption);
public function get ReferralChasing() : ReferralChasingOption;
public function set ReferralChasing(ReferralChasingOption);

Property Value

One of the ReferralChasingOption values. The default is External.


Exception Type Condition
InvalidEnumArgumentException The value is not one of the ReferralChasingOption values.


If the root search is not specified in the naming context of the server or when the search results cross a naming context (for example, when you have child domains and search in the parent domain), the server sends a referral message to the client that the client can choose to ignore or chase.

The following table shows the ReferralChasingOption values.

Value Description
None Do not chase referrals. This prevents a client from contacting other servers in a referral process.
Subordinate The client chases only subordinate referrals that are a subordinate naming context in a directory tree. The Active Directory Service Interfaces (ADSI) Lightweight Directory Access Protocol (LDAP) provider always turns off this flag for paged searches.
External The client chases external referrals.
All The client chases both subordinate and external referrals.

For more information on these values, see ReferralChasingOption.


Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family

.NET Framework Security: 

See Also

DirectorySearcher Class | DirectorySearcher Members | System.DirectoryServices Namespace | ReferralChasingOption