SearchParameters

The SearchParameters class allows setting parameters for a directory search.

Namespace: Softerra.Adaxes.Adsi.Search

Constructors

Properties

  • Property

  • Description

  • Asynchronous

  • Gets or sets a value that indicates whether the search is performed asynchronously.

  • AttributeScopeQuery

  • Gets or sets LDAP name of the DN-syntax property to search in.

  • BaseObjectPath

  • Gets or sets the ADS path of the directory object to start the search from.

  • CacheResults

  • Gets or sets a value indicating whether search results are cached on the client computer.

  • ClientTimeout

  • Gets or sets the maximum amount of time that the client waits for the server to return results.

  • DerefAlias

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

  • DirectorySynchronization

  • Gets or sets an object that represents a directory synchronization control to be used during the search.

  • ExtendedDN

  • Gets or sets a format for distinguished names.

  • Criteria

  • Gets or sets the search criteria.

  • PageSize

  • Gets or sets the number of search results returned per page.

  • PagingInfo

  • Gets or sets a value that contains information about a paged search.

  • PropertiesToLoad

  • Gets a collection of properties to retrieve during the search.

  • PropertyNamesOnly

  • Gets or sets a value that indicates whether the directory search retrieves only the names of the properties to which values have been assigned.

  • ReferralChasing

  • Gets or sets a value indicating how referrals are chased during the search.

  • SearchScope

  • Gets or sets a value indicating the scope of the directory search that is observed by the server.

  • SecurityMasks

  • Gets or sets a value indicating which security access information for the specified properties should be returned by the search.

  • ServerTimeLimit

  • Gets or sets a value indicating the maximum amount of time the server spends searching.

  • SizeLimit

  • Gets or sets a value indicating the maximum number of objects that the server returns in the search.

  • Sort

  • Gets or sets a value indicating the property by which the results are sorted.

  • Tombstone

  • Gets or sets a value indicating whether the search should also return deleted objects that match the search filter.

  • VirtualListView

  • Gets or sets a value indicating the virtual list view options for the search.

  • VirtualRoot

  • Gets or sets a value indicating whether the search is performed in all the domains managed by Adaxes.

Details

SearchParameters()

Constructs a new instance of the SearchParameters class.

SearchParameters()

Asynchronous

Gets or sets a value that indicates whether the search is performed asynchronously.

  • Type:
  • bool
  • Access:
  • Read/Write

AttributeScopeQuery

Gets or sets LDAP name of the DN-syntax property to search in.

  • Type:
  • string
  • Access:
  • Read/Write

Remarks

DN-syntax properties are properties containing distinguished names of directory objects. For example, if you want to search among members of a group, you should specify "member" as a value of the property.

Only one property can be used for this type of search. To execute such a search, set the SearchScope property to ADS_SCOPE_BASE.


BaseObjectPath

Gets or sets the ADS path of the directory object to start the search from.

Remarks

This property is ignored if the VirtualRoot property is set to true.


CacheResults

Gets or sets a value indicating whether search results are cached on the client computer.

  • Type:
  • bool
  • Access:
  • Read/Write

ClientTimeout

Gets or sets the maximum amount of time that the client waits for the server to return results. If the server does not respond within the time specified, the search is aborted, and no results are returned.

  • Type:
  • TimeSpan
  • Access:
  • Read/Write

DerefAlias

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


DirectorySynchronization

Gets or sets an object that represents a directory synchronization control to be used during the search. The DirSync control enables you to search a directory partition for objects that have changed since a previous state. The state is identified by a search cookie returned by the server after each search. To get the cookie, use the AdmDirectorySynchronization::GetCookie method. On subsequent searches, pass the cookie to the constructor of the AdmDirectorySynchronization class.

The base object of such a search must be the root of a directory partition, which can be a domain partition, the configuration partition, or the schema partition. The scope of a DirSync search must be ADS_SCOPE_SUBTREE, that is, the entire subtree of the partition.


ExtendedDN

Gets or sets a format for distinguished names.


Criteria

Gets or sets the search criteria. For details about building search criteria, see How to build criteria.


PageSize

Gets or sets the number of search results returned per page.

  • Type:
  • int
  • Access:
  • Read/Write

PagingInfo

Gets or sets a value that contains information about a paged search.

Remarks

Since virtual list view search is not supported by the Windows 2000 server, there is a need to have the ability to get a particular page. That can be implemented using the PageSize property by fetching all results until the requested search page is reached, however this is too expensive. Usage of this property prevents unnecessary passing of all search results through the pipeline.


PropertiesToLoad

Gets a collection of properties to retrieve during the search.

  • Type:
  • stringCollection
  • Access:
  • Read-only

PropertyNamesOnly

Gets or sets a value that indicates whether the directory search retrieves only the names of the properties to which values have been assigned.

  • Type:
  • bool
  • Access:
  • Read/Write

ReferralChasing

Gets or sets a value indicating how referrals are chased during the search.


SearchScope

Gets or sets a value indicating the scope of the directory search that is observed by the server.


SecurityMasks

Gets or sets a value indicating which security access information for the specified properties should be returned by the search.


ServerTimeLimit

Gets or sets a value indicating the maximum amount of time the server spends searching. If the time limit is reached, only entries that are found up to that point are returned.

  • Type:
  • TimeSpan
  • Access:
  • Read/Write

SizeLimit

Gets or sets a value indicating the maximum number of objects that the server returns in the search.

  • Type:
  • int
  • Access:
  • Read/Write

Sort

Gets or sets a value indicating the property by which the results are sorted.


Tombstone

Gets or sets a value indicating whether the search should also return deleted objects that match the search filter.

  • Type:
  • bool
  • Access:
  • Read/Write

VirtualListView

Gets or sets a value indicating the virtual list view options for the search.


VirtualRoot

Gets or sets a value indicating whether the search is performed in all the domains managed by Adaxes.

  • Type:
  • bool
  • Access:
  • Read/Write

Remarks

If set to true, the BaseObjectPath property is ignored, and the SearchScope property must be set to ADS_SCOPE_SUBTREE.


Requirements

Minimum required version: 2023

See also