Displaying page content

To retrieve content from individual content-only pages in your MVC application, use the generated strongly typed classes provided by the system for each page type. You can use the retrieved page content to populate prepared view models and then display them in your views.

Generated provider classes facilitate the retrieval of individual pages of the corresponding page type. The following example demonstrates the use of a provider class generated for a sample Article page type:

// Gets the specified articles using the generated provider
IEnumerable<Article> articles = ArticleProvider.GetArticles()
    .OnSite("MySite")
    .Culture("en-US")
    .Path("/Articles/", PathTypeEnum.Children);

// Gets the published version of a single article using the generated provider
Article article = ArticleProvider.GetArticle(nodeGuid, "en-US", "MySite");

By default, the generated code returns published versions of pages. If you need to retrieve the latest edited version of a page, use the following approach:

// Gets the latest version of a single article using the generated provider
Article article = ArticleProvider.GetArticle(nodeGuid, "en-US", "MySite")
    .LatestVersion()
    .Published(false);

To filter the retrieved pages, use any of the query parameters for single page types type listed in Reference - DocumentQuery methods.

Working with retrieved page data

You can access the data of a retrieved page through the properties of the object. The following types of page data are available:

• Page fields – the data that is editable on a page’s Content tab.
• General page data – properties available for all pages (via the TreeNode class). For example identifiers, values indicating the position in the content tree, etc.
• Metadata – data like the page title and page keywords.
• Page attachments – stored in fields with the File or Attachments data type. For information about retrieving page attachments, see Displaying page attachments.

// Retrieves a specific page
News news = NewsProvider.GetNews(nodeGuid, "en-US", "MySite");

// Accesses the ID of the page's parent node in the content tree
int parentNodeId = news.NodeParentID;

// Accesses the 'DocumentPageTitle' metadata field
string pageTitle = news.DocumentPageTitle;

Accessing page field data

The fields available on a page’s Content tab are specific to its Page type. You can see the fields that each page type uses:

• In Page types (application)->edit page type->Fields tab
• In the corresponding <namespace>_<page_type_code_name> database table

We recommend accessing specific fields of a page type via the Fields property:

// Retrieves a specific page
News news = NewsProvider.GetNews(nodeGuid, "en-US", "MySite");

// Accesses the 'Title' field
string title = news.Fields.Title;

// Accesses the 'Text' field
string text = news.Fields.Text;

@Html.Raw(Model.<Rich text field content>)
@Html.Kentico().ResolveUrls(Model.<Rich text field content>)