Hide menu Last updated: Oct 27 2016
Area: Episerver CMS Applies to versions: 10 and higher
Other versions:

Searching for pages based on page type

You can programmatically search for Episerver CMS pages based on a certain page type. By specifying search criteria and a place to start the search you gets a PageDataCollection containing matching pages.

The DataFactory contains a method called FindPagesWithCriteria which takes a PageReference (representing where to start the search) and a PropertyCriteriaCollection object (representing what to search for). When the FindPagesWithCriteria method is called it returns a PageDataCollection object containing matching pages.

Creating a criteria collection

  1. Create a PropertyCriteriaCollection object that contains the individual PropertyCriteria objects:
    PropertyCriteriaCollection criterias = new PropertyCriteriaCollection();
  2. Create a PropertyCriteria object that contains the information about the property criteria for the search:

Creating a search criteria

Define the search criteria by creating a PropertyCriteria object that contains the information about the property criteria for the search:

  1. Set the Condition property to specify the type of comparison you want; for example, CompareCondition.Equal.
  2. Set the Name property to the PageTypeID property.
  3. Set the Type property to the PageType property.
  4. Set the Value property to specify what page type to search for; (the load of a page type is based on its name); for example, PageTypeNewsItem.
  5. Set the Required property to true. This criterion is required for a match.
PropertyCriteria criteria = new PropertyCriteria();
criteria.Condition = CompareCondition.Equal;
criteria.Name = "PageTypeID";
criteria.Type = PropertyDataType.PageType;
criteria.Value = Locate.ContentTypeRepository().Load("PageTypeNewsItem").ID.ToString();
criteria.Required = true;

Creating additional search criteria

Define another search criterion by creating a PropertyCriteria object that contains the information about the property criteria for the search:

  1. Set the Condition property to specify the type of comparison you want; for example, CompareCondition.GreaterThan.
    PropertyCriteriaCollection criterias = new PropertyCriteriaCollection();
  2. Set the Name property to the PageCreated property.
  3. Set the Type property to the Date property.
  4. Set the Value property to specify a period of time; for example, set to search for pages that are created during the last 120 days.
  5. Set the Required property to true, this criterion is required for a match.
PropertyCriteria secCriteria = new PropertyCriteria();
secCriteria.Condition = EPiServer.Filters.CompareCondition.GreaterThan;
secCriteria.Name = "PageCreated";
secCriteria.Type = PropertyDataType.Date;
secCriteria.Value = DateTime.Now.AddDays(-120).ToString();
secCriteria.Required = true;

Adding your criteria to the criteria collection

Add your specified criteria to the criteria collection as follows:

criterias.Add(criteria);
criterias.Add(secCriteria);

Executing the search

After you specify criteria,  define where to start the search. Use the start page as the search starting point.

Note: The following example may return quite a few matches (and in some cases could be time-consuming).

PageDataCollection _newsPageItems = Locate.PageCriteriaQueryService().FindPagesWithCriteria(PageReference.StartPage, criterias);

FilterForVisitor

Filter for visitors. The following filter removes pages that the current user does not have access to or that are not currently published:

FilterForVisitor.Filter(_newsPageItems);
new FilterSort(FilterSortOrder.PublishedDescending).Filter(_newsPageItems);

You can find the source code for the PageDataCollection and PageData classes the Framework Reference section under the Remarks section for the class.

Comments