Resource Binding

In DotVVM 1.1, the resource bindings have changed. The @resourceType and @resourceNamespace directives are no longer supported. The @import directive is used instead.

Thhe resource binding is used to access values from .NET resource files (RESX). The default syntax is {resource: FullNamespace.ResourceClass.ResourceKey}. This finds the appropriate RESX file and use the value with the specified key.

For example, if you have a project named MyWebApp and you have a Resources\Web\Strings.resx file in the project, the resource class will be MyWebApp.Resources.Web.Strings (provided you haven't change the default namespace in the project properties). To retrieve the resource, you need to use {resource: MyWebApp.Resources.Web.String.SomeResourceKey}

Because this syntax is quite long, there are two ways on how to make it shorter.

The @resourceType Directive

Using the @resourceType directive in the page, you can specify the default resource class. Then you can only use the resource key in the binding.

@resourceType MyWebApp.Resources.Web.Strings, MyWebApp

{{resource: ResourceKey}}

Of course you can still use the full specification to retrieve the value, which is handy when you need to get a resource from a different RESX file.

The @resourceNamespace Directive

If you have multiple resource files that you need in the page, a better way is to use the @resourceNamespace directive. You can specify the namespace in which the resource classes reside.

For example, in a project with the Resources\Web\Strings1.resx and Resources\Web\Strings2.resx files, the markup can look like this:

@resourceNamespace MyWebApp.Resources.Web

{{resource: Strings1.SomeResource}}
{{resource: Strings2.SomeResource}}

The resource bindings are always evaluated on the server. When evaluating, the CurrentUICulture of the thread that handles the HTTP request will be used.

See the Globalization section for more information about working with the request cultures.