AppSettingsExpressionBuilder Klasse

Definition

Namespace:
System.Web.Compilation
Assembly:
System.Web.dll

Ruft Werte, wie in einem deklarativen Ausdruck angegeben, aus dem <appSettings> Abschnitt der Web.config Datei ab.

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
Vererbung
Object
ExpressionBuilder
AppSettingsExpressionBuilder

Beispiele

Im folgenden Codebeispiel wird das Abrufen eines Anwendungseinstellungswerts auf einer Seite veranschaulicht, die nicht kompiliert wird.

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

Dieser Code ruft den folgenden Ausdruck aus der datei Web.config ab.

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

<appSettings>

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

</appSettings>

</configuration>

Hinweise

Die AppSettingsExpressionBuilder Klasse bietet Zugriff auf Werte im <appSettings> Abschnitt der Web.config-Datei. Der <appSettings> Abschnitt der Web.config-Datei enthält anwendungsspezifische Werte in Schlüssel-Wert-Paaren.

Ein Anwendungswert wird abgerufen, indem ein Ausdruck des Formulars zugewiesen wird.

<%$ AppSettings: appSettingsKey %>

zu einer Eigenschaft in einer Steuerelementdeklaration. Der Teil des Ausdrucks vor dem Doppelpunkt (:) bestimmt den Typ des abzurufenden Ausdrucks, und der Teil nach dem Doppelpunkt kennzeichnet den Schlüssel. Der vorherige Ausdruck würde den folgenden Wert aus der Web.config-Datei abrufen.

<appSettings>

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

</appSettings>

Wenn der Seitenparser auf einen Ausdruck mit dem AppSettings Präfix trifft, wird eine Instanz der AppSettingsExpressionBuilder Klasse zum Behandeln des Ausdrucks erstellt.

Wenn der Ausdruck auf einer Seite gefunden wird, die kompiliert wird, generiert das AppSettingsExpressionBuilder Objekt Code, um den angegebenen Wert aus der Web.config Datei abzurufen. Dieser Code wird während der Ausführung der generierten Seitenklasse ausgeführt. Wenn der Ausdruck auf einer Seite gefunden wird, die nicht kompiliert wird, gibt das AppSettingsExpressionBuilder Objekt den Wert aus der Web.config Datei zurück, wenn die Seite analysiert und ausgeführt wird.

Konstruktoren

Name Beschreibung
AppSettingsExpressionBuilder()

Initialisiert eine neue Instanz der AppSettingsExpressionBuilder-Klasse.

Eigenschaften

Name Beschreibung
SupportsEvaluate

Gibt einen Wert zurück, der angibt, ob ein Ausdruck auf einer Seite ausgewertet werden kann, die nicht kompiliert wird.

Methoden

Name Beschreibung
Equals(Object)

Bestimmt, ob das angegebene Objekt dem aktuellen Objekt entspricht.

(Geerbt von Object)
EvaluateExpression(Object, BoundPropertyEntry, Object, ExpressionBuilderContext)

Gibt einen Wert aus dem <appSettings> Abschnitt der Web.config-Datei zurück.
GetAppSetting(String, Type, String)

Gibt einen Wert aus dem <appSettings> Abschnitt der Web.config-Datei zurück, wobei der Wert in einen Zieltyp konvertiert wurde.
GetAppSetting(String)

Gibt einen Wert aus dem <appSettings> Abschnitt der Web.config-Datei zurück.
GetCodeExpression(BoundPropertyEntry, Object, ExpressionBuilderContext)

Gibt einen Codeausdruck zurück, der zum Ausführen der Eigenschaftszuweisung in der generierten Seitenklasse verwendet wird.
GetHashCode()

Dient als Standardhashfunktion.

(Geerbt von Object)
GetType()

Ruft die Type der aktuellen Instanz ab.

(Geerbt von Object)
MemberwiseClone()

Erstellt eine flache Kopie der aktuellen Object.

(Geerbt von Object)
ParseExpression(String, Type, ExpressionBuilderContext)

Wenn eine abgeleitete Klasse überschrieben wird, wird ein Objekt zurückgegeben, das den analysierten Ausdruck darstellt.

(Geerbt von ExpressionBuilder)
ToString()

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

(Geerbt von Object)

Gilt für:

Weitere Informationen