The basic syntax of an ASP.NET expression is the following:

<%$ expressionPrefix: expressionValue %>

The dollar sign ($) indicates to ASP.NET that an expression follows. The expression prefix defines the type of expression, such as AppSettings, ConnectionStrings, or Resources. Following the colon (:) is the actual expression value that ASP.NET will resolve.

Expression syntax is not bound to any specific .NET language. You can use the same expression syntax whether you use Visual Basic, C#, or any other programming language in your ASP.NET pages.

A common use of expressions is to set the connection string property of a control, such as the SqlDataSource control, based on the value of a connection string stored in the Web.config file. For example, you might have the following SqlDataSource control with a connection string attribute:

<asp:SqlDataSource ID="SqlDataSource1" Runat="server" 
    SelectCommand="SELECT * FROM [Employees]"
    ConnectionString="<%$ ConnectionStrings:NorthwindConnectionString1 %>">
</asp:SqlDataSource>

The highlighted code shows an expression, which is contained within the quotation marks and denotes the attribute's value. The expression references a connection string named "NorthwindConnectionString1" that is defined in the connectionStrings element of the Web.config file. The connectionStrings element might look like the following:

<configuration>
  <connectionStrings>
    <add name="NorthwindConnectionString1" 
      connectionString="Data Source=localhost;Integrated Security=SSPI;Initial Catalog=Northwind;"
      providerName="System.Data.SqlClient" />
  </connectionStrings>
    <!-- additional settings -->
</configuration>

Note:
It is recommended for added security that you encrypt the section of the configuration file that contains connection strings. For details, see Encrypting Configuration Information Using Protected Configuration. In the preceding example, the configuration section of the configuration file is shown unencrypted for clarity.

Each connection string is given a name, which you can use in an expression to reference it within your ASP.NET pages.

In addition to using expressions for connection strings, you can use expressions to reference application settings defined in a configuration file accessible to the Web site. For example, you might have frequently used strings, such as your site's copyright message, stored in the appSettings section of your Web.config file, which might look like the following:

<appSettings>
  <add key="copyright" value="(c)Copyright 2004 Northwind Traders"/>
</appSettings>

Within your ASP.NET pages, you could reference the value by using an expression similar to the following:

<%$ AppSettings: copyright %>

This would enable you to maintain frequently cited elements within the configuration file rather than having to change the same text on every page.

If you want to use an expression as a static value on your page or control, you use an expression as part of an ASP.NET server control. A typical strategy is to add a Literal control and set its Text property to an expression. For example, to place a copyright notice at the bottom of every page you could use the following:

<p align="center">

<asp:Literal runat="server" text="<%$ AppSettings: copyright %>"/>

</p>

In addition to displaying values contained in a configuration file, you can display values that are stored in resource (.resx or .resource) files. You typically use resource files to store information for a specific language or language and culture combination. By using resource files and expressions, you can create a Web page that displays text in different languages depending on values determined at run time, such as the language and culture setting reported by the browser, or an explicit language choice by the user.

For example, when localizing content automatically, you can set the Text property of a server control using expression syntax, as in this example:

<asp:Label id="label1" runat="server" text="<%$ Resources: Messages, ThankYouLabel %>" />

In the App_GlobalResources folder, you could have resource files named Messages.resx, Messages.es.resx, Message.de.resx, and so on—a Messages resource file for each language you want to support. The Messages.resx file represents the neutral (fallback) resource that is used if no explicit culture is set. In the Messages.resx file, you might have an entry like this:

<data name="ThankYouLabel"><value>Thank you very much!</value></data>

You would have similar entries in other resource files, with the strings translated appropriately for the language represented by that resource file. For more information on using expressions for resources and localization, see ASP.NET Web Page Resources Overview.

Concepts

Other Resources