/// <summary>
/// A new, improved ContactsView method (Listing 6-16)
/// </summary>
/// <param name="folderId">Folder to perform FindItem in</param>
/// <param name="responseShape">ResponseShape for returned contacts</param>
/// <param name="pathForRestriction">The property path to compare against</param>
/// <param name="lowerBounds">lower bounds string (inclusive)</param>
/// <param name="upperBounds">upper bounds string (exclusive)</param>
/// <param name="offset">For indexed paging, the offset into the result set to start at</param>
/// <param name="maxEntries">Max entries to return for each page. Zero for unbounded</param>
/// <returns>FindItemResponseMessageType</returns>
///
public FindItemResponseMessageType SuperContactsView(
BaseFolderIdType folderId,
ItemResponseShapeType responseShape,
BasePathToElementType pathForRestriction,
string lowerBounds,
string upperBounds,
int offset,
int maxEntries)
{
FindItemType request = new FindItemType();
request.ItemShape = responseShape;
// If they set a maxEntries > 0, use indexed paging just to limit the results.
//
if (maxEntries > 0)
{
IndexedPageViewType paging = new IndexedPageViewType();
paging.BasePoint = IndexBasePointType.Beginning;
paging.Offset = offset;
paging.MaxEntriesReturned = maxEntries;
paging.MaxEntriesReturnedSpecified = true;
request.Item = paging;
}
request.ParentFolderIds = new BaseFolderIdType[] { folderId };
request.Traversal = ItemQueryTraversalType.Shallow;
// Build up our restriction
//
AndType and = new AndType();
IsGreaterThanOrEqualToType lowerBoundsFilter = new IsGreaterThanOrEqualToType();
lowerBoundsFilter.Item = pathForRestriction;
lowerBoundsFilter.FieldURIOrConstant = new FieldURIOrConstantType();
ConstantValueType lowerBoundsValue = new ConstantValueType();
lowerBoundsValue.Value = lowerBounds;
lowerBoundsFilter.FieldURIOrConstant.Item = lowerBoundsValue;
IsLessThanType upperBoundsFilter = new IsLessThanType();
upperBoundsFilter.Item = pathForRestriction;
upperBoundsFilter.FieldURIOrConstant = new FieldURIOrConstantType();
ConstantValueType upperBoundsValue = new ConstantValueType();
upperBoundsValue.Value = upperBounds;
upperBoundsFilter.FieldURIOrConstant.Item = upperBoundsValue;
and.Items = new SearchExpressionType[] { lowerBoundsFilter, upperBoundsFilter };
request.Restriction = new RestrictionType();
request.Restriction.Item = and;
// Make the request
//
FindItemResponseType response = this.FindItem(request);
return response.ResponseMessages.Items[0] as FindItemResponseMessageType;
}
/// <summary>
/// Convenience constructor
/// </summary>
/// <param name="sortDirection">Direction of the sort</param>
/// <param name="propertyPath">Property path used for this field order</param>
///
public FieldOrderType(SortDirectionType sortDirection, BasePathToElementType propertyPath)
{
this.orderField = sortDirection;
this.itemField = propertyPath;
}
/// <summary>
/// Constructor
/// </summary>
/// <param name="propertyPath">PropertyPath for this single change</param>
/// <param name="itemWithChange">The item along with the change</param>
///
public SetItemFieldType(BasePathToElementType propertyPath, ItemType itemWithChange)
{
this.Item = propertyPath;
this.Item1 = itemWithChange;
}
