ReportingService2010.FindItems Method

Definition

Returns items from a report server database or SharePoint library that match the search criteria.

public:
 cli::array <ReportService2010::CatalogItem ^> ^ FindItems(System::String ^ Folder, ReportService2010::BooleanOperatorEnum BooleanOperator, cli::array <ReportService2010::Property ^> ^ SearchOptions, cli::array <ReportService2010::SearchCondition ^> ^ SearchConditions);
[System.Web.Services.Protocols.SoapDocumentMethod("http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer/FindItems", ParameterStyle=System.Web.Services.Protocols.SoapParameterStyle.Wrapped, RequestNamespace="http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer", ResponseNamespace="http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer", Use=System.Web.Services.Description.SoapBindingUse.Literal)]
[System.Web.Services.Protocols.SoapHeader("ServerInfoHeaderValue", Direction=System.Web.Services.Protocols.SoapHeaderDirection.Out)]
[System.Web.Services.Protocols.SoapHeader("TrustedUserHeaderValue")]
public ReportService2010.CatalogItem[] FindItems (string Folder, ReportService2010.BooleanOperatorEnum BooleanOperator, ReportService2010.Property[] SearchOptions, ReportService2010.SearchCondition[] SearchConditions);
[<System.Web.Services.Protocols.SoapDocumentMethod("http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer/FindItems", ParameterStyle=System.Web.Services.Protocols.SoapParameterStyle.Wrapped, RequestNamespace="http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer", ResponseNamespace="http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer", Use=System.Web.Services.Description.SoapBindingUse.Literal)>]
[<System.Web.Services.Protocols.SoapHeader("ServerInfoHeaderValue", Direction=System.Web.Services.Protocols.SoapHeaderDirection.Out)>]
[<System.Web.Services.Protocols.SoapHeader("TrustedUserHeaderValue")>]
member this.FindItems : string * ReportService2010.BooleanOperatorEnum * ReportService2010.Property[] * ReportService2010.SearchCondition[] -> ReportService2010.CatalogItem[]
Public Function FindItems (Folder As String, BooleanOperator As BooleanOperatorEnum, SearchOptions As Property(), SearchConditions As SearchCondition()) As CatalogItem()

Parameters

Folder
String

The fully qualified URL of the folder to search. To search the entire report server database, specify the root folder (/).

BooleanOperator
BooleanOperatorEnum

The logical operator that is applied to connect the search conditions. Possible values are AND and OR. The default value is AND.

SearchOptions
Property[]

An array of Property objects that defines the names and values of search options.

The supported search options are:

Resursive: specify True to perform recursive search in all subfolders; otherwise, False.

SearchConditions
SearchCondition[]

An array of SearchCondition objects that defines the property names and values for which to search.

Returns

An array of CatalogItem objects in the report server database that correspond to the specified search criteria.

Attributes

Remarks

The table below shows header and permissions information on this operation.

SOAP Header Usage (In) TrustedUserHeaderValue

(Out) ServerInfoHeaderValue
Native Mode Required Permissions None
SharePoint Mode Required Permissions None

The length of the Folder parameter cannot exceed 260 characters; otherwise, a SOAP exception is thrown with the error code rsItemLengthExceeded.

The Folder parameter cannot be null or empty or contain the following reserved characters: : ? ; @ & = + $ , \ * > < | . ". You can use the forward slash character (/) to separate items in the full path name of the folder, but you cannot use it at the end of the folder name.

Only one instance of a property name can be supplied in the set of search conditions, and the search text is case-insensitive.

The report server does not support wildcard characters in the middle of the search condition. Wildcard characters include %, _, [, ], ^, and -. If a wildcard character is present, the report server treats the character literally.

The items that are returned are only those for which a user has ReadProperties permission in native mode and <xref:Microsoft.SharePoint.SPBasePermissions.ViewListItems> permission in SharePoint integrated mode.

In SharePoint mode, this method does not return any item of type Resource, because resources are not stored in, nor synchronized to, the report server database in SharePoint mode.

Applies to