ExchangeService.FindItems Method
Definition
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
A collection of items.
Remarks
Calling this method results in a call to Exchange Web Services (EWS).
Applies to
FindItems(WellKnownFolderName, SearchFilter, ViewBase, Grouping)
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
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
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
A collection of items.
Remarks
Calling this method results in a call to Exchange Web Services (EWS).
Applies to
FindItems(FolderId, SearchFilter, ViewBase, Grouping)
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
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
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
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
A collection of items.
Remarks
Calling this method results in a call to Exchange Web Services (EWS).
Applies to
FindItems(FolderId, SearchFilter, ViewBase)
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
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
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
A collection of items.
Remarks
Calling this method results in a call to Exchange Web Services (EWS).
Applies to
FindItems(WellKnownFolderName, SearchFilter, ViewBase)
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
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
A collection of items.
Remarks
Calling this method results in a call to Exchange Web Services (EWS).
Applies to
Feedback
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see: https://aka.ms/ContentUserFeedback.
Submit and view feedback for