Search Method (SearchClause, SearchOptions, Boolean)

Article
11/12/2009

Executes a unified search for campaign items using the provided search options and performance data option.

Namespace: Microsoft.CommerceServer.Marketing
Assembly: Microsoft.CommerceServer.Marketing.CrossTierTypes (in Microsoft.CommerceServer.Marketing.CrossTierTypes.dll)

Syntax

'Declaration
Public Function Search ( _
    clause As SearchClause, _
    searchOptions As SearchOptions, _
    includePerformanceData As Boolean _
) As DataSet

'Usage
Dim instance As CampaignItemManager
Dim clause As SearchClause
Dim searchOptions As SearchOptions
Dim includePerformanceData As Boolean
Dim returnValue As DataSet

returnValue = instance.Search(clause, _
    searchOptions, includePerformanceData)

public DataSet Search(
    SearchClause clause,
    SearchOptions searchOptions,
    bool includePerformanceData
)

public:
DataSet^ Search(
    SearchClause^ clause, 
    SearchOptions^ searchOptions, 
    bool includePerformanceData
)

public function Search(
    clause : SearchClause, 
    searchOptions : SearchOptions, 
    includePerformanceData : boolean
) : DataSet

Parameters

clause
Type: Microsoft.CommerceServer..::.SearchClause
A SearchClause containing the search clause or term created by SearchClauseFactory.

searchOptions
Type: Microsoft.CommerceServer..::.SearchOptions
A SearchOptions containing the search options. Passing nullNothingnullptra null reference (Nothing in Visual Basic) means to use default search options.

includePerformanceData
Type: System..::.Boolean
true to indicate to include performance data; otherwise, false.

Return Value

Type: System.Data..::.DataSet
A DataSet containing the search results.

Exceptions

Exception	Condition
ArgumentException	The entity to search is not of CampaignItem type.
ArgumentNullException	No entity type was specified for the search.
EntityDoesNotExistException	Entity type being searched is not in the list of searchable entities.
SearchRecordsPerPageException	The number of records per page requested is greater than the system configured limit.
SearchPageNumberException	Exception is thrown when a requested page (other than the first page) contains no search result records.
SearchException	The clause does not have a valid XML format.

Remarks

The includePerformanceData is a flag to indicate whether to include a DataTable with performance data (event counts) in the resulting DataSet. Performance data is only returned for items in the result set.

This method uses the long running SQL command, sqlCommandTimeoutSeconds, of MarketingServices. The long running SQL command time out default is specified in web.config and is normally 120 seconds.

Permissions

Full trust for the immediate caller. This member cannot be used by partially trusted code. For more information, see Using Libraries from Partially Trusted Code.

Share via