AppSettingsExpressionEditor Classe

Definição

public ref class AppSettingsExpressionEditor : System::Web::UI::Design::ExpressionEditor

public class AppSettingsExpressionEditor : System.Web.UI.Design.ExpressionEditor

type AppSettingsExpressionEditor = class
    inherit ExpressionEditor

Public Class AppSettingsExpressionEditor
Inherits ExpressionEditor

Herança

Object

ExpressionEditor

AppSettingsExpressionEditor

Exemplos

O seguinte exemplo de código demonstra como associar a NavigateUrl propriedade de um HyperLink controlo a uma expressão de definição de aplicação usando o AppSettingsExpressionEditor objeto.

1. Num projeto Web Forms, adicione MyHyperLinkSetting à <appSettings> secção do ficheiro web.config.

   <FileName>web.config</FileName>
   <RelevantItems>
       <Reference>System.Web.UI.Design.AppSettingExpressionEditor</Reference>
   </RelevantItems>
   

2. Numa página de Formulários Web, adicione um HyperLink controlo.

3. Para o Hyperlink controlo, em Propriedades, clique em Expressões e depois no botão de reticência (...).

   Aparece a <Hyperlinkname> caixa de diálogo Expressão.

4. Em Propriedades Vinculáveis, clique em NavegarUrl, na lista de tipos de Expressão, clique em AppSettings, e depois, em Propriedades de Expressão, na caixa AppSetting, escreva MyHyperLinkSetting.

O designer visual usa o AppSettingsExpressionEditor para atribuir a expressão à NavigateUrl propriedade.

A seguinte fonte aspx mostra um exemplo de conjunto de valores de propriedade usando uma expressão de definição de aplicação.

<!-- Define a hyperlink that maps the NavigateUrl property to the
     MyHyperLinkSetting value in the Web.Config appSettings section. -->
<asp:HyperLink runat="server" ID="HyperLink1" 
     NavigateUrl="<%$ AppSettings:MyHyperLinkSetting %>">
     HyperLink using an AppSetting expression
</asp:HyperLink>

<!-- Define a hyperlink that maps the NavigateUrl property to the
     MyHyperLinkSetting value in the Web.Config appSettings section. -->
<asp:HyperLink runat="server" ID="HyperLink1" 
     NavigateUrl="<%$ AppSettings:MyHyperLinkSetting %>">
     HyperLink using an AppSetting expression
</asp:HyperLink>

<FileName>ControlsUsingExpressions.aspx</FileName>
<RelevantItems>
    <Reference>System.Web.UI.Design.AppSettingExpressionEditor</Reference>
</RelevantItems>

Observações

A AppSettingsExpressionEditor classe é derivada da ExpressionEditor classe e fornece uma implementação para avaliar e associar uma referência de configuração de aplicação a uma propriedade de controlo no momento do design. Por exemplo, pode vincular o valor de uma propriedade de controlo à expressão AppSettings:mySettingKeyNamede definição da aplicação , o que indica que o valor da propriedade de controlo é definido usando o mySettingKeyName valor na appSettings secção do ficheiro de configuração Web.

Um host visual designer, como o Visual Studio 2005, usa a classe AppSettingsExpressionEditor para selecionar uma configuração de aplicação da secção de configuração appSettings, e depois avalia a expressão selecionada para renderização em tempo de design.

Quando navega até à Expressions propriedade para um controlo na grelha de propriedades em tempo de design, o designer visual apresenta uma caixa de diálogo para definir expressões que fornecem o valor em tempo de execução para uma propriedade de controlo. Pode selecionar o tipo de expressão com base numa lista de prefixos de expressão. Quando seleciona o prefixo de expressão AppSettings da lista, o anfitrião designer visual utiliza o objeto associado ExpressionEditorSheet para fornecer funcionalidade de edição em tempo de design das appSettings expressões e utiliza AppSettingsExpressionEditor métodos para avaliar e converter a string de expressão com base na sintaxe de uma expressão de definição de aplicação. O anfitrião designer visual utiliza o resultado da expressão avaliada para atribuir valores de propriedades de controlo que são renderizados na superfície de design.

A ExpressionPrefix propriedade para um AppSettingsExpressionEditor objeto devolve a cadeia AppSettings. A AppSettingsExpressionBuilder classe está associada ao prefixo AppSettings de expressão e à AppSettingsExpressionEditor implementação.

O EvaluateExpression método avalia uma cadeia de expressão de definição de aplicação de entrada. O GetExpressionEditorSheet método devolve a ExpressionEditorSheet implementação que é usada para introduzir e editar expressões de definição de aplicação.

Ver também

• AppSettings
• AppSettingsExpressionBuilder
• ExpressionEditorSheet
• ExpressionBuilder
• Expressions
• ExpressionEditorAttribute