ExchangeService.FindItems Method

Reference

Definition

Namespace:: Microsoft.Exchange.WebServices.Data

Assembly:: Microsoft.Exchange.WebServices.dll

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.

Overloads

FindItems(FolderId, String, ViewBase)	Returns items from a target folder according to the associated search query with the specified preview page view. The FindItems(FolderId, String, ViewBase) method is applicable for clients that target Exchange Online and versions of Exchange starting with Exchange Server 2010.
FindItems(WellKnownFolderName, SearchFilter, ViewBase, Grouping)	Returns grouped items filtered by type from the target folder according to the specified preview page view.
FindItems(FolderId, String, Boolean, ViewBase)	Returns items from a target folder according to the associated search query with the specified preview page view and optional term highlighting. The FindItems(FolderId, String, Boolean, ViewBase) method is applicable for clients that target Exchange Online and versions of Exchange starting with Exchange Server 2013.
FindItems(FolderId, String, ViewBase, Grouping)	Returns grouped items from a target folder according to the specified query.The FindItems(FolderId, String, ViewBase, Grouping) method is applicable for clients that target Exchange Online and versions of Exchange starting with Exchange Server 2010.
FindItems(FolderId, SearchFilter, ViewBase, Grouping)	Obtains a grouped list of items by searching the contents of a specific folder.
FindItems(WellKnownFolderName, String, ViewBase)	Returns items from a target folder using the associated query with the specified preview page view. The FindItems(WellKnownFolderName, String, ViewBase) method is applicable for clients that target Exchange Online and versions of Exchange starting with Exchange Server 2010.
FindItems(FolderId, ViewBase, Grouping)	Returns grouped items from a target folder with the specified preview page view.
FindItems(WellKnownFolderName, String, ViewBase, Grouping)	Returns grouped items from a target folder using the associated query with the specified preview page view. The FindItems(WellKnownFolderName, String, ViewBase, Grouping) method is applicable for clients that target Exchange Online and versions of Exchange starting with Exchange Server 2010.
FindItems(FolderId, SearchFilter, ViewBase)	Returns items from a target folder filtered by item type with the specified preview page view.
FindItems(WellKnownFolderName, ViewBase)	Returns items from a target folder with the specified preview page view.
FindItems(FolderId, ViewBase)	Returns items from a target folder with the specified preview page view.
FindItems(WellKnownFolderName, SearchFilter, ViewBase)	Returns items filtered by type from a target folder with the specified preview page view.
FindItems(FolderId, String, Boolean, ViewBase, Grouping)	Returns grouped items from a target folder according to the associated search query, optionally with terms highlighted. The FindItems(FolderId, String, Boolean, ViewBase, Grouping) method is applicable for clients that target Exchange Online and versions of Exchange starting with Exchange Server 2013.

FindItems(FolderId, String, ViewBase)

Returns items from a target folder according to the associated search query with the specified preview page view. The FindItems(FolderId, String, ViewBase) method is applicable for clients that target Exchange Online and versions of Exchange starting with Exchange Server 2010.

public:
 Microsoft::Exchange::WebServices::Data::FindItemsResults<Microsoft::Exchange::WebServices::Data::Item ^> ^ FindItems(Microsoft::Exchange::WebServices::Data::FolderId ^ parentFolderId, System::String ^ queryString, Microsoft::Exchange::WebServices::Data::ViewBase ^ view);

public Microsoft.Exchange.WebServices.Data.FindItemsResults<Microsoft.Exchange.WebServices.Data.Item> FindItems (Microsoft.Exchange.WebServices.Data.FolderId parentFolderId, string queryString, Microsoft.Exchange.WebServices.Data.ViewBase view);

Public Function FindItems (parentFolderId As FolderId, queryString As String, view As ViewBase) As FindItemsResults(Of Item)

Parameters

parentFolderId: FolderId

The ID of the folder in which to search for items.

queryString: String

The query used to specify the search.

view: ViewBase

A value that determines the number of items per preview page.

Returns

FindItemsResults<Item>

A collection of items.

Remarks

Calling this method results in a call to Exchange Web Services (EWS).

Applies to

Returns grouped items filtered by type from the target folder according to the specified preview page view.

public:
 Microsoft::Exchange::WebServices::Data::GroupedFindItemsResults<Microsoft::Exchange::WebServices::Data::Item ^> ^ FindItems(Microsoft::Exchange::WebServices::Data::WellKnownFolderName parentFolderName, Microsoft::Exchange::WebServices::Data::SearchFilter ^ searchFilter, Microsoft::Exchange::WebServices::Data::ViewBase ^ view, Microsoft::Exchange::WebServices::Data::Grouping ^ groupBy);

public Microsoft.Exchange.WebServices.Data.GroupedFindItemsResults<Microsoft.Exchange.WebServices.Data.Item> FindItems (Microsoft.Exchange.WebServices.Data.WellKnownFolderName parentFolderName, Microsoft.Exchange.WebServices.Data.SearchFilter searchFilter, Microsoft.Exchange.WebServices.Data.ViewBase view, Microsoft.Exchange.WebServices.Data.Grouping groupBy);

Parameters

parentFolderName: WellKnownFolderName

The name of the folder in which to search for items.

searchFilter: SearchFilter

The filter used to narrow search results.

view: ViewBase

A value that determines the number of items per preview page.

groupBy: Grouping

Specifies the grouping for items returned by the search query.

Returns

GroupedFindItemsResults<Item>

A collection of items.

Remarks

Calling this method results in a call to Exchange Web Services (EWS).

Applies to

FindItems(FolderId, String, Boolean, ViewBase)

Returns items from a target folder according to the associated search query with the specified preview page view and optional term highlighting. The FindItems(FolderId, String, Boolean, ViewBase) method is applicable for clients that target Exchange Online and versions of Exchange starting with Exchange Server 2013.

public:
 Microsoft::Exchange::WebServices::Data::FindItemsResults<Microsoft::Exchange::WebServices::Data::Item ^> ^ FindItems(Microsoft::Exchange::WebServices::Data::FolderId ^ parentFolderId, System::String ^ queryString, bool returnHighlightTerms, Microsoft::Exchange::WebServices::Data::ViewBase ^ view);

public Microsoft.Exchange.WebServices.Data.FindItemsResults<Microsoft.Exchange.WebServices.Data.Item> FindItems (Microsoft.Exchange.WebServices.Data.FolderId parentFolderId, string queryString, bool returnHighlightTerms, Microsoft.Exchange.WebServices.Data.ViewBase view);

Public Function FindItems (parentFolderId As FolderId, queryString As String, returnHighlightTerms As Boolean, view As ViewBase) As FindItemsResults(Of Item)

Parameters

parentFolderId: FolderId

The ID of the folder in which to search for items.

queryString: String

The query used to specify the search.

returnHighlightTerms: Boolean

A flag indicating whether highlighted terms should be returned in the response.

view: ViewBase

A value that determines the number of items per preview page.

Returns

FindItemsResults<Item>

A collection of items.

Remarks

Calling this method results in a call to Exchange Web Services (EWS).

Applies to

FindItems(FolderId, String, ViewBase, Grouping)

Returns grouped items from a target folder according to the specified query.The FindItems(FolderId, String, ViewBase, Grouping) method is applicable for clients that target Exchange Online and versions of Exchange starting with Exchange Server 2010.

public:
 Microsoft::Exchange::WebServices::Data::GroupedFindItemsResults<Microsoft::Exchange::WebServices::Data::Item ^> ^ FindItems(Microsoft::Exchange::WebServices::Data::FolderId ^ parentFolderId, System::String ^ queryString, Microsoft::Exchange::WebServices::Data::ViewBase ^ view, Microsoft::Exchange::WebServices::Data::Grouping ^ groupBy);

public Microsoft.Exchange.WebServices.Data.GroupedFindItemsResults<Microsoft.Exchange.WebServices.Data.Item> FindItems (Microsoft.Exchange.WebServices.Data.FolderId parentFolderId, string queryString, Microsoft.Exchange.WebServices.Data.ViewBase view, Microsoft.Exchange.WebServices.Data.Grouping groupBy);

Public Function FindItems (parentFolderId As FolderId, queryString As String, view As ViewBase, groupBy As Grouping) As GroupedFindItemsResults(Of Item)

Parameters

parentFolderId: FolderId

The ID of the folder in which to search for items.

queryString: String

The query used to specify the search.

view: ViewBase

A value that determines the number of items per preview page.

groupBy: Grouping

Specifies the grouping for items returned by the search query.

Returns

GroupedFindItemsResults<Item>

A collection of items.

Remarks

Calling this method results in a call to Exchange Web Services (EWS).

Applies to

Obtains a grouped list of items by searching the contents of a specific folder.

public:
 Microsoft::Exchange::WebServices::Data::GroupedFindItemsResults<Microsoft::Exchange::WebServices::Data::Item ^> ^ FindItems(Microsoft::Exchange::WebServices::Data::FolderId ^ parentFolderId, Microsoft::Exchange::WebServices::Data::SearchFilter ^ searchFilter, Microsoft::Exchange::WebServices::Data::ViewBase ^ view, Microsoft::Exchange::WebServices::Data::Grouping ^ groupBy);

public Microsoft.Exchange.WebServices.Data.GroupedFindItemsResults<Microsoft.Exchange.WebServices.Data.Item> FindItems (Microsoft.Exchange.WebServices.Data.FolderId parentFolderId, Microsoft.Exchange.WebServices.Data.SearchFilter searchFilter, Microsoft.Exchange.WebServices.Data.ViewBase view, Microsoft.Exchange.WebServices.Data.Grouping groupBy);

Parameters

parentFolderId: FolderId

The ID of the folder in which to search for items.

searchFilter: SearchFilter

The filter used to narrow search results.

view: ViewBase

A value that determines the number of items per preview page.

groupBy: Grouping

Specifies the grouping for items returned by the search query.

Returns

GroupedFindItemsResults<Item>

A collection of items.

Remarks

Calling this method results in a call to Exchange Web Services (EWS).

Applies to

FindItems(WellKnownFolderName, String, ViewBase)

Returns items from a target folder using the associated query with the specified preview page view. The FindItems(WellKnownFolderName, String, ViewBase) method is applicable for clients that target Exchange Online and versions of Exchange starting with Exchange Server 2010.

public:
 Microsoft::Exchange::WebServices::Data::FindItemsResults<Microsoft::Exchange::WebServices::Data::Item ^> ^ FindItems(Microsoft::Exchange::WebServices::Data::WellKnownFolderName parentFolderName, System::String ^ queryString, Microsoft::Exchange::WebServices::Data::ViewBase ^ view);

public Microsoft.Exchange.WebServices.Data.FindItemsResults<Microsoft.Exchange.WebServices.Data.Item> FindItems (Microsoft.Exchange.WebServices.Data.WellKnownFolderName parentFolderName, string queryString, Microsoft.Exchange.WebServices.Data.ViewBase view);

Public Function FindItems (parentFolderName As WellKnownFolderName, queryString As String, view As ViewBase) As FindItemsResults(Of Item)

Parameters

parentFolderName: WellKnownFolderName

The name of the folder in which to search for items.

queryString: String

The query used to specify the search.

view: ViewBase

A value that determines the number of items per preview page.

Returns

FindItemsResults<Item>

A collection of items.

Remarks

Calling this method results in a call to Exchange Web Services (EWS).

Applies to

FindItems(FolderId, ViewBase, Grouping)

Returns grouped items from a target folder with the specified preview page view.

public:
 Microsoft::Exchange::WebServices::Data::GroupedFindItemsResults<Microsoft::Exchange::WebServices::Data::Item ^> ^ FindItems(Microsoft::Exchange::WebServices::Data::FolderId ^ parentFolderId, Microsoft::Exchange::WebServices::Data::ViewBase ^ view, Microsoft::Exchange::WebServices::Data::Grouping ^ groupBy);

public Microsoft.Exchange.WebServices.Data.GroupedFindItemsResults<Microsoft.Exchange.WebServices.Data.Item> FindItems (Microsoft.Exchange.WebServices.Data.FolderId parentFolderId, Microsoft.Exchange.WebServices.Data.ViewBase view, Microsoft.Exchange.WebServices.Data.Grouping groupBy);

Public Function FindItems (parentFolderId As FolderId, view As ViewBase, groupBy As Grouping) As GroupedFindItemsResults(Of Item)

Parameters

parentFolderId: FolderId

The ID of the folder in which to search for items.

view: ViewBase

A value that determines the number of items per preview page.

groupBy: Grouping

Specifies the grouping for items returned by the search query.

Returns

GroupedFindItemsResults<Item>

A collection of items.

Remarks

Calling this method results in a call to Exchange Web Services (EWS).

Applies to

FindItems(WellKnownFolderName, String, ViewBase, Grouping)

Returns grouped items from a target folder using the associated query with the specified preview page view. The FindItems(WellKnownFolderName, String, ViewBase, Grouping) method is applicable for clients that target Exchange Online and versions of Exchange starting with Exchange Server 2010.

public:
 Microsoft::Exchange::WebServices::Data::GroupedFindItemsResults<Microsoft::Exchange::WebServices::Data::Item ^> ^ FindItems(Microsoft::Exchange::WebServices::Data::WellKnownFolderName parentFolderName, System::String ^ queryString, Microsoft::Exchange::WebServices::Data::ViewBase ^ view, Microsoft::Exchange::WebServices::Data::Grouping ^ groupBy);

public Microsoft.Exchange.WebServices.Data.GroupedFindItemsResults<Microsoft.Exchange.WebServices.Data.Item> FindItems (Microsoft.Exchange.WebServices.Data.WellKnownFolderName parentFolderName, string queryString, Microsoft.Exchange.WebServices.Data.ViewBase view, Microsoft.Exchange.WebServices.Data.Grouping groupBy);

Public Function FindItems (parentFolderName As WellKnownFolderName, queryString As String, view As ViewBase, groupBy As Grouping) As GroupedFindItemsResults(Of Item)

Parameters

parentFolderName: WellKnownFolderName

The name of the folder in which to search for items.

queryString: String

The query used to specify the search.

view: ViewBase

A value that determines the number of items per preview page.

groupBy: Grouping

Specifies the grouping for items returned by the search query.

Returns

GroupedFindItemsResults<Item>

A collection of items.

Remarks

Calling this method results in a call to Exchange Web Services (EWS).

Applies to

Returns items from a target folder filtered by item type with the specified preview page view.

public:
 Microsoft::Exchange::WebServices::Data::FindItemsResults<Microsoft::Exchange::WebServices::Data::Item ^> ^ FindItems(Microsoft::Exchange::WebServices::Data::FolderId ^ parentFolderId, Microsoft::Exchange::WebServices::Data::SearchFilter ^ searchFilter, Microsoft::Exchange::WebServices::Data::ViewBase ^ view);

public Microsoft.Exchange.WebServices.Data.FindItemsResults<Microsoft.Exchange.WebServices.Data.Item> FindItems (Microsoft.Exchange.WebServices.Data.FolderId parentFolderId, Microsoft.Exchange.WebServices.Data.SearchFilter searchFilter, Microsoft.Exchange.WebServices.Data.ViewBase view);

Parameters

parentFolderId: FolderId

The ID of the folder in which to search for items.

searchFilter: SearchFilter

The filter used to narrow search results.

view: ViewBase

A value that determines the number of items per preview page.

Returns

FindItemsResults<Item>

A collection of items.

Remarks

Calling this method results in a call to Exchange Web Services (EWS).

Applies to

FindItems(WellKnownFolderName, ViewBase)

Returns items from a target folder with the specified preview page view.

public:
 Microsoft::Exchange::WebServices::Data::FindItemsResults<Microsoft::Exchange::WebServices::Data::Item ^> ^ FindItems(Microsoft::Exchange::WebServices::Data::WellKnownFolderName parentFolderName, Microsoft::Exchange::WebServices::Data::ViewBase ^ view);

public Microsoft.Exchange.WebServices.Data.FindItemsResults<Microsoft.Exchange.WebServices.Data.Item> FindItems (Microsoft.Exchange.WebServices.Data.WellKnownFolderName parentFolderName, Microsoft.Exchange.WebServices.Data.ViewBase view);

Public Function FindItems (parentFolderName As WellKnownFolderName, view As ViewBase) As FindItemsResults(Of Item)

Parameters

parentFolderName: WellKnownFolderName

The name of the folder in which to search for items.

view: ViewBase

A value that determines the number of items per preview page.

Returns

FindItemsResults<Item>

A collection of items.

Remarks

Calling this method results in a call to Exchange Web Services (EWS).

Applies to

FindItems(FolderId, ViewBase)

Returns items from a target folder with the specified preview page view.

public:
 Microsoft::Exchange::WebServices::Data::FindItemsResults<Microsoft::Exchange::WebServices::Data::Item ^> ^ FindItems(Microsoft::Exchange::WebServices::Data::FolderId ^ parentFolderId, Microsoft::Exchange::WebServices::Data::ViewBase ^ view);

public Microsoft.Exchange.WebServices.Data.FindItemsResults<Microsoft.Exchange.WebServices.Data.Item> FindItems (Microsoft.Exchange.WebServices.Data.FolderId parentFolderId, Microsoft.Exchange.WebServices.Data.ViewBase view);

Public Function FindItems (parentFolderId As FolderId, view As ViewBase) As FindItemsResults(Of Item)

Parameters

parentFolderId: FolderId

The ID of the folder in which to search for items.

view: ViewBase

A value that determines the number of items per preview page.

Returns

FindItemsResults<Item>

A collection of items.

Remarks

Calling this method results in a call to Exchange Web Services (EWS).

Applies to

Returns items filtered by type from a target folder with the specified preview page view.

public:
 Microsoft::Exchange::WebServices::Data::FindItemsResults<Microsoft::Exchange::WebServices::Data::Item ^> ^ FindItems(Microsoft::Exchange::WebServices::Data::WellKnownFolderName parentFolderName, Microsoft::Exchange::WebServices::Data::SearchFilter ^ searchFilter, Microsoft::Exchange::WebServices::Data::ViewBase ^ view);

public Microsoft.Exchange.WebServices.Data.FindItemsResults<Microsoft.Exchange.WebServices.Data.Item> FindItems (Microsoft.Exchange.WebServices.Data.WellKnownFolderName parentFolderName, Microsoft.Exchange.WebServices.Data.SearchFilter searchFilter, Microsoft.Exchange.WebServices.Data.ViewBase view);

Parameters

parentFolderName: WellKnownFolderName

The name of the folder in which to search for items.

searchFilter: SearchFilter

The filter used to narrow search results.

view: ViewBase

A value that determines the number of items per preview page.

Returns

FindItemsResults<Item>

A collection of items.

Remarks

Calling this method results in a call to Exchange Web Services (EWS).

Applies to

FindItems(FolderId, String, Boolean, ViewBase, Grouping)

Returns grouped items from a target folder according to the associated search query, optionally with terms highlighted. The FindItems(FolderId, String, Boolean, ViewBase, Grouping) method is applicable for clients that target Exchange Online and versions of Exchange starting with Exchange Server 2013.

public:
 Microsoft::Exchange::WebServices::Data::GroupedFindItemsResults<Microsoft::Exchange::WebServices::Data::Item ^> ^ FindItems(Microsoft::Exchange::WebServices::Data::FolderId ^ parentFolderId, System::String ^ queryString, bool returnHighlightTerms, Microsoft::Exchange::WebServices::Data::ViewBase ^ view, Microsoft::Exchange::WebServices::Data::Grouping ^ groupBy);

public Microsoft.Exchange.WebServices.Data.GroupedFindItemsResults<Microsoft.Exchange.WebServices.Data.Item> FindItems (Microsoft.Exchange.WebServices.Data.FolderId parentFolderId, string queryString, bool returnHighlightTerms, Microsoft.Exchange.WebServices.Data.ViewBase view, Microsoft.Exchange.WebServices.Data.Grouping groupBy);

Public Function FindItems (parentFolderId As FolderId, queryString As String, returnHighlightTerms As Boolean, view As ViewBase, groupBy As Grouping) As GroupedFindItemsResults(Of Item)

Parameters

parentFolderId: FolderId

The ID of the folder in which to search for items.

queryString: String

The query used to specify the search.

returnHighlightTerms: Boolean

A flag indicating whether highlighted terms should be returned in the response.

view: ViewBase

The view controlling the number of items returned.

groupBy: Grouping

Specifies the grouping for items returned by the search query.

Returns

GroupedFindItemsResults<Item>

A collection of items.

Remarks

Calling this method results in a call to Exchange Web Services (EWS).

Applies to

Share via

ExchangeService.FindItems Method

Definition

Overloads

FindItems(FolderId, String, ViewBase)

Parameters

Returns

Remarks

Applies to

FindItems(WellKnownFolderName, SearchFilter, ViewBase, Grouping)

Parameters

Returns

Remarks

Applies to

FindItems(FolderId, String, Boolean, ViewBase)

Parameters

Returns

Remarks

Applies to

FindItems(FolderId, String, ViewBase, Grouping)

Parameters

Returns

Remarks

Applies to

FindItems(FolderId, SearchFilter, ViewBase, Grouping)

Parameters

Returns

Remarks

Applies to

FindItems(WellKnownFolderName, String, ViewBase)

Parameters

Returns

Remarks

Applies to

FindItems(FolderId, ViewBase, Grouping)

Parameters

Returns

Remarks

Applies to

FindItems(WellKnownFolderName, String, ViewBase, Grouping)

Parameters

Returns

Remarks

Applies to

FindItems(FolderId, SearchFilter, ViewBase)

Parameters

Returns

Remarks

Applies to

FindItems(WellKnownFolderName, ViewBase)

Parameters

Returns

Remarks

Applies to

FindItems(FolderId, ViewBase)

Parameters

Returns

Remarks

Applies to

FindItems(WellKnownFolderName, SearchFilter, ViewBase)

Parameters

Returns

Remarks

Applies to

FindItems(FolderId, String, Boolean, ViewBase, Grouping)

Parameters

Returns

Remarks

Applies to

Feedback

Additional resources