Freigeben über


AppSettingsExpressionEditor Klasse

Definition

Stellt Eigenschaften und Methoden für das Evaluieren und Bearbeiten eines Ausdrucks für Anwendungseinstellungen in einer Konfigurationsdatei zur Entwurfszeit bereit.

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
Vererbung
AppSettingsExpressionEditor

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die NavigateUrl Eigenschaft eines HyperLink Steuerelements mithilfe AppSettingsExpressionEditor des -Objekts an einen Anwendungseinstellungsausdruck gebunden wird.

  1. Fügen Sie in einem Web Forms Projekt dem <appSettings> Abschnitt der web.config-Datei hinzuMyHyperLinkSetting.

    <FileName>web.config</FileName>
    <RelevantItems>
        <Reference>System.Web.UI.Design.AppSettingExpressionEditor</Reference>
    </RelevantItems>
    
  2. Fügen Sie auf einer Web Forms Seite ein Steuerelement hinzuHyperLink.

  3. Klicken Sie für das Hyperlink Steuerelement in Eigenschaften auf Ausdrücke, und klicken Sie dann auf die Schaltfläche mit den Auslassungspunkten (...).

    Das <Hyperlinkname> Dialogfeld Ausdruck wird angezeigt.

  4. Klicken Sie unter Bindungsfähige Eigenschaften auf NavigateUrl, in der Liste Ausdruckstyp auf AppSettings, und geben Sie dann unter Ausdruckseigenschaften im Feld AppSettingden Namen MyHyperLinkSetting ein.

Der visuelle Designer verwendet den AppSettingsExpressionEditor , um den Ausdruck für die NavigateUrl -Eigenschaft zuzuweisen.

Die folgende ASPX-Quelle zeigt ein Beispiel für einen Eigenschaftenwertsatz mit einem Anwendungseinstellungsausdruck.

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

Hinweise

Die AppSettingsExpressionEditor -Klasse wird von der ExpressionEditor -Klasse abgeleitet und bietet eine Implementierung zum Bewerten und Zuordnen eines Anwendungseinstellungsverweiss zu einer Steuerelementeigenschaft zur Entwurfszeit. Beispielsweise können Sie den Wert einer Steuerelementeigenschaft an den Anwendungseinstellungsausdruck AppSettings:mySettingKeyNamebinden, der angibt, dass der Steuerelementeigenschaftswert mithilfe des mySettingKeyName Werts im Abschnitt der appSettings Webkonfigurationsdatei festgelegt wird.

Ein Visual Designer-Host, z. B. Visual Studio 2005, verwendet die AppSettingsExpressionEditor -Klasse, um eine Anwendungseinstellung aus dem appSettings Konfigurationsabschnitt auszuwählen, und wertet dann den ausgewählten Ausdruck für das Rendering zur Entwurfszeit aus.

Wenn Sie im Raster entwurfszeiteigenschaften zur Expressions Eigenschaft für ein Steuerelement navigieren, zeigt der visuelle Designer ein Dialogfeld an, um Ausdrücke festzulegen, die den Laufzeitwert für eine Steuerelementeigenschaft bereitstellen. Sie können den Ausdruckstyp basierend auf einer Liste von Ausdruckspräfixen auswählen. Wenn Sie das Präfix AppSettings-Ausdruck aus der Liste auswählen, verwendet der Visual Designer-Host das zugeordnete ExpressionEditorSheet Objekt, um Entwurfszeitbearbeitungsfunktionen von appSettings Ausdrücken bereitzustellen, und verwendet AppSettingsExpressionEditor Methoden, um die Ausdruckszeichenfolge basierend auf der Syntax für einen Anwendungseinstellungsausdruck auszuwerten und zu konvertieren. Der Host des visuellen Designers verwendet das ausgewertete Ausdrucksergebnis, um Steuerelementeigenschaftenwerte zuzuweisen, die auf der Entwurfsoberfläche gerendert werden.

Die ExpressionPrefix -Eigenschaft für ein AppSettingsExpressionEditor -Objekt gibt die Zeichenfolge AppSettingszurück. Die AppSettingsExpressionBuilder -Klasse ist dem Ausdruckspräfix AppSettings und der AppSettingsExpressionEditor Implementierung zugeordnet.

Die EvaluateExpression -Methode wertet eine Eingabeanwendungseinstellungsausdruckzeichenfolge aus. Die GetExpressionEditorSheet -Methode gibt die Implementierung zurück, die ExpressionEditorSheet zum Eingeben und Bearbeiten von Anwendungseinstellungsausdrücken verwendet wird.

Konstruktoren

AppSettingsExpressionEditor()

Initialisiert eine neue Instanz der AppSettingsExpressionEditor-Klasse.

Eigenschaften

ExpressionPrefix

Ruft das Ausdruckspräfix ab, das die Ausdruckszeichenfolgen kennzeichnet, die von der Implementierung des Ausdrucks-Editors unterstützt werden.

(Geerbt von ExpressionEditor)

Methoden

Equals(Object)

Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist.

(Geerbt von Object)
EvaluateExpression(String, Object, Type, IServiceProvider)

Wertet eine Ausdruckszeichenfolge für Anwendungseinstellungen aus und stellt den Entwurfszeitwert für eine Steuerelementeigenschaft bereit.

GetExpressionEditorSheet(String, IServiceProvider)

Gibt ein Ausdrucks-Editorblatt für eine Anwendungseinstellung zurück.

GetHashCode()

Fungiert als Standardhashfunktion.

(Geerbt von Object)
GetType()

Ruft den Type der aktuellen Instanz ab.

(Geerbt von Object)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.

(Geerbt von Object)
ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.

(Geerbt von Object)

Gilt für:

Weitere Informationen