AppSettingsExpressionBuilder Класс

Ссылка

Определение

Пространство имен:: System.Web.Compilation

Сборка:: System.Web.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Возвращает значения из раздела файла Web.config <appSettings>, как указано в декларативном выражении.

public ref class AppSettingsExpressionBuilder : System::Web::Compilation::ExpressionBuilder

public class AppSettingsExpressionBuilder : System.Web.Compilation.ExpressionBuilder

type AppSettingsExpressionBuilder = class
    inherit ExpressionBuilder

Public Class AppSettingsExpressionBuilder
Inherits ExpressionBuilder

Наследование: Object

ExpressionBuilder
AppSettingsExpressionBuilder

Примеры

В следующем примере кода показано, как получить значение параметров приложения на странице, которая не скомпилирована.

<%@ Page Language="C#" CompilationMode="Never" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>Noncompiled Page</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
        Welcome to the 
        <asp:Literal ID="Literal1" runat="server" 
        Text="<%$ AppSettings: thisSeason %>" /> Sale!
    </div>
    </form>
</body>
</html>

<%@ Page Language="VB" CompilationMode="Never" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>Noncompiled Page</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
        Welcome to the 
        <asp:Literal ID="Literal1" runat="server" 
        Text="<%$ AppSettings: thisSeason %>" /> Sale!
    </div>
    </form>
</body>
</html>

Этот код извлекает следующее выражение из файла Web.config.

<configuration xmlns="http://schemas.microsoft.com/.NetConfiguration/v2.0">

<appSettings>

<add key="thisSeason" value="Fall"/>

</appSettings>

</configuration>

Класс AppSettingsExpressionBuilder предоставляет доступ к значениям в <appSettings> разделе файла Web.config. Раздел <appSettings> файла Web.config содержит значения, относящиеся к приложению, в парах "ключ-значение".

Значение приложения извлекается путем назначения выражения формы

<%$ AppSettings: appSettingsKey %>

свойство в объявлении элемента управления. Часть выражения перед двоеточием (:) обозначает тип извлекаемого выражения, а часть после двоеточия обозначает ключ. Предыдущее выражение извлекает следующее значение из файла Web.config.

<appSettings>

<add key="appSettingsKey" value="appSettingsValue"/>

</appSettings>

Когда средство синтаксического анализа страницы встречает выражение с AppSettings префиксом, он создает экземпляр AppSettingsExpressionBuilder класса для обработки выражения.

Если выражение встречается на странице, которая будет скомпилирована, AppSettingsExpressionBuilder объект создает код для получения указанного значения из файла Web.config. Этот код выполняется во время выполнения созданного класса страницы. Если выражение встречается на странице, которая не будет скомпилирована, AppSettingsExpressionBuilder объект возвращает значение из файла Web.config при синтаксическом анализе и выполнении страницы.

Конструкторы

AppSettingsExpressionBuilder()

Инициализирует новый экземпляр класса AppSettingsExpressionBuilder.

Свойства

SupportsEvaluate

Возвращает значение, позволяющее определить, можно ли вычислить выражение на странице, которая не подлежит компиляции.

Методы

Equals(Object)	Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object)
EvaluateExpression(Object, BoundPropertyEntry, Object, ExpressionBuilderContext)	Возвращает значение из раздела `<appSettings>` файла Web.config.
GetAppSetting(String)	Возвращает значение из раздела `<appSettings>` файла Web.config.
GetAppSetting(String, Type, String)	Возвращает из раздела `<appSettings>` файла Web.config значение, тип которого приведен к целевому типу.
GetCodeExpression(BoundPropertyEntry, Object, ExpressionBuilderContext)	Возвращает выражение кода, используемое для присвоения свойства в созданном классе страницы.
GetHashCode()	Служит хэш-функцией по умолчанию. (Унаследовано от Object)
GetType()	Возвращает объект Type для текущего экземпляра. (Унаследовано от Object)
MemberwiseClone()	Создает неполную копию текущего объекта Object. (Унаследовано от Object)
ParseExpression(String, Type, ExpressionBuilderContext)	При переопределении в производном классе возвращает объект, представляющий проанализированное выражение. (Унаследовано от ExpressionBuilder)
ToString()	Возвращает строку, представляющую текущий объект. (Унаследовано от Object)

Применяется к