Request context
The DotvvmViewModelBase
class defines the Context
property which provides access to various DotVVM and ASP.NET resources, like ASP.NET Core or OWIN HTTP context etc. You can also make redirects, return files, and more.
Request information
IsPostBack
property determines whether the current request is postback, or whether the page is loaded for the first time.Parameters
property is a dictionary which contains values of the route parameters.Query
property is a dictionary which contains parameters from the URL query string.HttpContext
property gives you access to the OWIN or ASP.NET context of the current request. It's useful when you need to work with cookies, authentication etc. This property exposes a common interface overOwinContext
andHttpContext
from ASP.NET Core. Not all features are available in this abstraction because of the differences between the two platforms.GetAspNetCoreContext()
is an extension method which you can use in the ASP.NET Core version to access the ASP.NET CoreHttpContext
.GetOwinContext()
is an extension method which you can use in the OWIN version. It returns the realOwinContext
.
Validation
ModelState
property represents the state of the model validation. You can report validation errors to the UI using this object'sAddModelError
method, or you can use theIsValid
property to determine whether there are any validation errors in the page.- The
FailOnInvalidModelState
method checks the validity of the viewmodel and throws an exception if the viewmodel is not valid. The request execution is interrupted and the validation errors are displayed in the client's browser (e.g. in the ValidationSummary control).
Redirects
RedirectToRoute
andRedirectToRoutePermanent
methods redirect the user to the specified route and allows to supply route parameters. The request execution is interrupted by this call.RedirectToLocalUrl
method redirects the user to the specified URL and makes sure that the URL is not an absolute URL pointing to a different site. The request execution is interrupted by this call.RedirectToUrl
andRedirectToUrlPermanent
methods redirect the user to the specified URL. The request execution is interrupted by this call.
Returning files
ReturnFileAsync
function is used when you need to return a file which will be downloaded by the user.
Asynchronous operations
GetCancellationToken
returns a cancellation token for the current request. You can pass this token to a long-running operations so they can be canceled if the user leaves the page before it is loaded.
URL manipulation
TranslateVirtualPath
method can translate URLs from the~/some/path
notation to the domain-relative URLs (e. g./appVirtualDirectory/some/path
). This is useful if your application supports running in a virtual directory.