AppSettingsExpressionBuilder Classe

Definição

Espaço de Nomes:
System.Web.Compilation
Assemblagem:
System.Web.dll

Recupera valores, conforme especificado numa expressão declarativa, da <appSettings> secção do ficheiro Web.config.

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
Herança
Object
ExpressionBuilder
AppSettingsExpressionBuilder

Exemplos

O exemplo de código seguinte demonstra como recuperar um valor de definições de aplicação numa página que não está compilada.

<%@ 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>

Este código recupera a seguinte expressão do ficheiro Web.config.

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

<appSettings>

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

</appSettings>

</configuration>

Observações

A AppSettingsExpressionBuilder classe fornece acesso a valores na <appSettings> secção do ficheiro Web.config. A <appSettings> secção do ficheiro Web.config contém valores específicos da aplicação em pares chave/valor.

Um valor de aplicação é recuperado atribuindo uma expressão do formulário

<%$ AppSettings: appSettingsKey %>

a uma propriedade numa declaração de controlo. A parte da expressão antes dos dois-pontos (:) designa o tipo de expressão a recuperar, e a parte após o dois-pontos indica a chave. A expressão anterior recuperava o valor seguinte do ficheiro Web.config.

<appSettings>

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

</appSettings>

Quando o analisador de páginas encontra uma expressão com o AppSettings prefixo, cria uma instância da AppSettingsExpressionBuilder classe para tratar a expressão.

Se a expressão for encontrada numa página que será compilada, o AppSettingsExpressionBuilder objeto gera código para recuperar o valor especificado do ficheiro Web.config. Este código é executado durante a execução da classe de página gerada. Se a expressão for encontrada numa página que não será compilada, o AppSettingsExpressionBuilder objeto devolve o valor do ficheiro Web.config quando a página é analisada e executada.

Construtores

Name Description
AppSettingsExpressionBuilder()

Inicializa uma nova instância da AppSettingsExpressionBuilder classe.

Propriedades

Name Description
SupportsEvaluate

Devolve um valor que indica se uma expressão pode ser avaliada numa página que não está compilada.

Métodos

Name Description
Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
EvaluateExpression(Object, BoundPropertyEntry, Object, ExpressionBuilderContext)

Devolve um valor da <appSettings> secção do ficheiro Web.config.
GetAppSetting(String, Type, String)

Devolve um valor da <appSettings> secção do ficheiro Web.config com o valor convertido para um tipo alvo.
GetAppSetting(String)

Devolve um valor da <appSettings> secção do ficheiro Web.config.
GetCodeExpression(BoundPropertyEntry, Object, ExpressionBuilderContext)

Devolve uma expressão de código que é usada para realizar a atribuição de propriedades na classe de página gerada.
GetHashCode()

Serve como função de hash predefinida.

(Herdado de Object)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
MemberwiseClone()

Cria uma cópia superficial do atual Object.

(Herdado de Object)
ParseExpression(String, Type, ExpressionBuilderContext)

Quando sobrescrito numa classe derivada, devolve um objeto que representa a expressão analisada.

(Herdado de ExpressionBuilder)
ToString()

Devolve uma cadeia que representa o objeto atual.

(Herdado de Object)

Aplica-se a

Ver também