Property Purpose on a Razor page

Warning

This is an older way to customize the Dnn search index.

It is deprecated.

Use the new mechanisms explained in Search Customizations

To let your code know, if it's running to produce HTML or if it's running to fill the search-index.

Discover More in the Razor Tutorials

We have an rich series of Razor tutorials. You should really check them out 👍.

How to use

in most cases you'll use this within the CustomizeData event, in case you want to provide different data to the template than to the search.

In most cases you'll also want to override CustomizeSearch.

Note that it's of the type Purposes which is an enum containing

  • WebView,
  • IndexingForSearch,
  • PublishData
@using ToSic.Sxc.Blocks;
@if(Purpose == Purposes.IndexingForSearch){
    // code which should only run when indexing
}

Not run code, which can't run while indexing

Sometimes you also have code which requires a user to be visiting a page - like a permission check. Since the indexer doesn't have an HTTP session or a user, this will fail. So you could do something like:

@using ToSic.Sxc.Blocks;
@if(Purpose != Purposes.IndexingForSearch){
    // code which should only run when really viewing 
    // like something if(userIsLoggedIn) { ... }
}

History

  • 2sxc 10.20 - changed to Purpose from InstancePurpose - old code still works