AppSettingsExpressionEditor Klass

Definition

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

Arv

Object

ExpressionEditor

AppSettingsExpressionEditor

Exempel

I följande kodexempel visas hur du binder NavigateUrl egenskapen för en HyperLink kontroll till ett programinställningsuttryck med hjälp av AppSettingsExpressionEditor objektet.

1. I ett Web Forms-projekt lägger du till MyHyperLinkSetting i <appSettings> avsnittet i web.config-filen.

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

2. Lägg till en HyperLink kontroll på sidan Webbformulär.

3. För kontrollen Hyperlink i Egenskaper klickar du på Uttryck och sedan på ellipsknappen (...).

   Dialogrutan <Hyperlinkname>Uttryck visas.

4. Under Bindbara egenskaper klickar du på NavigateUrl, i listan Uttryckstyp klickar du på AppSettings och under Uttrycksegenskaper skriver du MyHyperLinkSetting i rutan AppSetting.

Den visuella designern använder AppSettingsExpressionEditor för att tilldela uttrycket för NavigateUrl egenskapen.

Följande aspx-källa visar ett exempel på en egenskapsvärdeuppsättning med ett programinställningsuttryck.

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

Kommentarer

Klassen AppSettingsExpressionEditor härleds från ExpressionEditor klassen och tillhandahåller en implementering för att utvärdera och associera en referens för programinställningar med en kontrollegenskap vid designtillfället. Du kan till exempel binda värdet för en kontrollegenskap till programinställningsuttrycket AppSettings:mySettingKeyName, vilket anger att värdet för kontrollegenskapen mySettingKeyName anges med hjälp av värdet i avsnittet i appSettings webbkonfigurationsfilen.

En visual designervärd, till exempel Visual Studio 2005, använder klassen AppSettingsExpressionEditor för att välja en programinställning från konfigurationsavsnittet appSettings och utvärderar sedan det valda uttrycket för designtidsåtergivning.

När du bläddrar till Expressions egenskapen för en kontroll i rutnätet för egenskaper för designtid visar den visuella designern en dialogruta för att ange uttryck som ger körningsvärdet för en kontrollegenskap. Du kan välja uttryckstyp baserat på en lista med uttrycksprefix. När du väljer prefixet AppSettings-uttryck i listan använder den visuella designervärden det associerade ExpressionEditorSheet objektet för att tillhandahålla designtidsredigeringsfunktioner appSettings för uttryck och använder AppSettingsExpressionEditor metoder för att utvärdera och konvertera uttryckssträngen baserat på syntaxen för ett programinställningsuttryck. Den visuella designervärden använder det utvärderade uttrycksresultatet för att tilldela kontrollegenskapsvärden som återges på designytan.

Egenskapen ExpressionPrefix för ett AppSettingsExpressionEditor objekt returnerar strängen AppSettings. Klassen AppSettingsExpressionBuilder är associerad med uttrycksprefixet AppSettings och implementeringen AppSettingsExpressionEditor .

Metoden EvaluateExpression utvärderar en uttryckssträng för indataprograminställning. Metoden GetExpressionEditorSheet returnerar den ExpressionEditorSheet implementering som används för att ange och redigera programinställningsuttryck.

Se även

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