AppSettingsExpressionEditor Classe

Definição

Fornece propriedades e métodos para avaliar e editar uma expressão de configuração de aplicativo em um arquivo de configuração no tempo de design.

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
AppSettingsExpressionEditor

Exemplos

O exemplo de código a seguir demonstra como associar a NavigateUrl propriedade de um HyperLink controle a uma expressão de configuração de aplicativo usando o AppSettingsExpressionEditor objeto.

  1. Em um projeto Web Forms, adicione MyHyperLinkSetting à <appSettings> seção do arquivo web.config.

    <FileName>web.config</FileName>
    <RelevantItems>
        <Reference>System.Web.UI.Design.AppSettingExpressionEditor</Reference>
    </RelevantItems>
    
  2. Em uma página Web Forms, adicione um HyperLink controle.

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

    A <Hyperlinkname> caixa de diálogo Expressão é exibida.

  4. Em propriedades associáveis, clique em NavigateUrl, na lista de tipos de expressão , clique em AppSettings e, em seguida, em Propriedades de Expressão, na caixa AppSetting , digite MyHyperLinkSetting.

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

A fonte aspx a seguir mostra um exemplo de um conjunto de valores de propriedade usando uma expressão de configuração de aplicativo.

<!-- 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>

Comentários

A AppSettingsExpressionEditor classe é derivada da ExpressionEditor classe e fornece uma implementação para avaliar e associar uma referência de configuração de aplicativo a uma propriedade de controle em tempo de design. Por exemplo, você pode associar o valor de uma propriedade de controle à expressão AppSettings:mySettingKeyNamede configuração do aplicativo, o que indica que o valor da propriedade de controle é definido usando o mySettingKeyName valor na appSettings seção do arquivo de configuração da Web.

Um host de designer visual, como Visual Studio 2005, usa a AppSettingsExpressionEditor classe para selecionar uma configuração de aplicativo na appSettings seção de configuração e, em seguida, avalia a expressão selecionada para renderização em tempo de design.

Quando você navega até a Expressions propriedade para obter um controle na grade de propriedades de tempo de design, o designer visual exibe uma caixa de diálogo para definir expressões que fornecem o valor de tempo de execução para uma propriedade de controle. Você pode selecionar o tipo de expressão com base em uma lista de prefixos de expressão. Quando você seleciona o prefixo de expressão AppSettings na lista, o host do designer visual usa o objeto associado ExpressionEditorSheet para fornecer a funcionalidade de edição em tempo de design de appSettings expressões e usa métodos para avaliar e converter a cadeia de caracteres AppSettingsExpressionEditor de expressão com base na sintaxe de uma expressão de configuração de aplicativo. O host do designer visual usa o resultado da expressão avaliada para atribuir valores de propriedade de controle que são renderizados na superfície de design.

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

O EvaluateExpression método avalia uma cadeia de caracteres de expressão de configuração de aplicativo de entrada. O GetExpressionEditorSheet método retorna a ExpressionEditorSheet implementação usada para inserir e editar expressões de configuração do aplicativo.

Construtores

AppSettingsExpressionEditor()

Inicializa uma nova instância da classe AppSettingsExpressionEditor.

Propriedades

ExpressionPrefix

Obtém o prefixo de expressão que identifica as cadeias de caracteres de expressão com suporte na implementação do editor de expressão.

(Herdado de ExpressionEditor)

Métodos

Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
EvaluateExpression(String, Object, Type, IServiceProvider)

Avalia uma cadeia de caracteres de expressão de configuração de aplicativo e fornece o valor temporal de design para uma propriedade de controle.

GetExpressionEditorSheet(String, IServiceProvider)

Retorna uma folha do editor de expressão para uma expressão de configuração de aplicativo.

GetHashCode()

Serve como a função de hash padrão.

(Herdado de Object)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
MemberwiseClone()

Cria uma cópia superficial do Object atual.

(Herdado de Object)
ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.

(Herdado de Object)

Aplica-se a

Confira também