/// <summary>
/// Internals the write search settings to XML.
/// </summary>
/// <param name="writer">The writer.</param>
/// <param name="groupBy">The group by clause.</param>
internal override void InternalWriteSearchSettingsToXml(EwsServiceXmlWriter writer, Grouping groupBy)
{
if (groupBy != null)
{
groupBy.WriteToXml(writer);
}
}
/// <summary>
/// Writes the search settings to XML.
/// </summary>
/// <param name="writer">The writer.</param>
/// <param name="groupBy">The group by clause.</param>
internal override void InternalWriteSearchSettingsToXml(EwsServiceXmlWriter writer, Grouping groupBy)
{
// No search settings for calendar views.
}
/// <summary>
/// Internals the write search settings to XML.
/// </summary>
/// <param name="writer">The writer.</param>
/// <param name="groupBy">The group by clause.</param>
internal override void InternalWriteSearchSettingsToXml(EwsServiceXmlWriter writer, Grouping groupBy)
{
if (groupBy != null)
{
groupBy.WriteToXml(writer);
}
}
/// <summary>
/// Internals the write search settings to XML.
/// </summary>
/// <param name="writer">The writer.</param>
/// <param name="groupBy">The group by.</param>
internal override void InternalWriteSearchSettingsToXml(EwsServiceXmlWriter writer, Grouping groupBy)
{
base.InternalWriteSearchSettingsToXml(writer, groupBy);
}
/// <summary>
/// Writes to XML.
/// </summary>
/// <param name="writer">The writer.</param>
/// <param name="groupBy">The group by clause.</param>
internal override void WriteToXml(EwsServiceXmlWriter writer, Grouping groupBy)
{
if (this.serviceObjType == ServiceObjectType.Item)
{
this.GetPropertySetOrDefault().WriteToXml(writer, this.GetServiceObjectType());
}
writer.WriteStartElement(XmlNamespace.Messages, this.GetViewXmlElementName());
this.InternalWriteViewToXml(writer);
writer.WriteEndElement(); // this.GetViewXmlElementName()
this.InternalWriteSearchSettingsToXml(writer, groupBy);
}
/// <summary>
/// Obtains a grouped list of items by searching the contents of this folder. Calling this method results in a call to EWS.
/// </summary>
/// <param name="queryString">query string to be used for indexed search</param>
/// <param name="view">The view controlling the number of items returned.</param>
/// <param name="groupBy">The grouping criteria.</param>
/// <returns>A collection of grouped items representing the contents of this folder.</returns>
public GroupedFindItemsResults <Item> FindItems(string queryString, ItemView view, Grouping groupBy)
{
EwsUtilities.ValidateParam(groupBy, "groupBy");
ServiceResponseCollection <FindItemResponse <Item> > responses = this.InternalFindItems <Item>(queryString, view, groupBy);
return(responses[0].GroupedFindResults);
}
/// <summary>
/// Obtains a grouped list of items by searching the contents of this folder. Calling this method results in a call to EWS.
/// </summary>
/// <param name="searchFilter">The search filter. Available search filter classes
/// include SearchFilter.IsEqualTo, SearchFilter.ContainsSubstring and
/// SearchFilter.SearchFilterCollection</param>
/// <param name="view">The view controlling the number of items returned.</param>
/// <param name="groupBy">The grouping criteria.</param>
/// <returns>A collection of grouped items representing the contents of this folder.</returns>
public GroupedFindItemsResults <Item> FindItems(SearchFilter searchFilter, ItemView view, Grouping groupBy)
{
EwsUtilities.ValidateParam(groupBy, "groupBy");
EwsUtilities.ValidateParamAllowNull(searchFilter, "searchFilter");
ServiceResponseCollection <FindItemResponse <Item> > responses = this.InternalFindItems <Item>(
searchFilter,
view,
groupBy);
return(responses[0].GroupedFindResults);
}
/// <summary> /// Writes the search settings to XML. /// </summary> /// <param name="writer">The writer.</param> /// <param name="groupBy">The group by clause.</param> internal abstract void InternalWriteSearchSettingsToXml(EwsServiceXmlWriter writer, Grouping groupBy);
/// <summary> /// Writes the grouping to json. /// </summary> /// <param name="service">The service.</param> /// <param name="groupBy">The group by.</param> /// <returns></returns> internal abstract object WriteGroupingToJson(ExchangeService service, Grouping groupBy);
/// <summary> /// Writes the search settings to XML. /// </summary> /// <param name="writer">The writer.</param> /// <param name="groupBy">The group by clause.</param> internal abstract void InternalWriteSearchSettingsToXml(EwsServiceXmlWriter writer, Grouping groupBy);
/// <summary>
/// Writes the grouping to json.
/// </summary>
/// <param name="service">The service.</param>
/// <param name="groupBy"></param>
/// <returns></returns>
internal override object WriteGroupingToJson(ExchangeService service, Grouping groupBy)
{
// No search settings for calendar views.
return(null);
}
/// <summary>
/// Writes the search settings to XML.
/// </summary>
/// <param name="writer">The writer.</param>
/// <param name="groupBy">The group by clause.</param>
internal override void InternalWriteSearchSettingsToXml(EwsServiceXmlWriter writer, Grouping groupBy)
{
// No search settings for calendar views.
}
/// <summary>
/// Internals the write search settings to XML.
/// </summary>
/// <param name="writer">The writer.</param>
/// <param name="groupBy">The group by.</param>
internal override void InternalWriteSearchSettingsToXml(EwsServiceXmlWriter writer, Grouping groupBy)
{
base.InternalWriteSearchSettingsToXml(writer, groupBy);
}
/// <summary>
/// Writes to XML.
/// </summary>
/// <param name="writer">The writer.</param>
/// <param name="groupBy">The group by clause.</param>
internal override void WriteToXml(EwsServiceXmlWriter writer, Grouping groupBy)
{
writer.WriteStartElement(XmlNamespace.Messages, this.GetViewXmlElementName());
this.InternalWriteViewToXml(writer);
writer.WriteEndElement(); // this.GetViewXmlElementName()
}
/// <summary>
/// Obtains a grouped list of items by searching the contents of this folder. Calling this method results in a call to EWS.
/// </summary>
/// <param name="queryString">query string to be used for indexed search</param>
/// <param name="view">The view controlling the number of items returned.</param>
/// <param name="groupBy">The grouping criteria.</param>
/// <returns>A collection of grouped items representing the contents of this folder.</returns>
public async Task <GroupedFindItemsResults <Item> > FindItems(string queryString, ItemView view, Grouping groupBy, CancellationToken token = default(CancellationToken))
{
EwsUtilities.ValidateParam(groupBy, "groupBy");
ServiceResponseCollection <FindItemResponse <Item> > responses = await this.InternalFindItems <Item>(queryString, view, groupBy, token).ConfigureAwait(false);
return(responses[0].GroupedFindResults);
}