ConnectionStringsExpressionBuilder Klasse

Referenz

Definition

Namespace:: System.Web.Compilation

Assembly:: System.Web.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Ruft Code ab oder generiert ihn, um Werte aus dem <connectionStrings>-Abschnitt der Datei „Web.config“ abzurufen.

public ref class ConnectionStringsExpressionBuilder : System::Web::Compilation::ExpressionBuilder

public class ConnectionStringsExpressionBuilder : System.Web.Compilation.ExpressionBuilder

type ConnectionStringsExpressionBuilder = class
    inherit ExpressionBuilder

Public Class ConnectionStringsExpressionBuilder
Inherits ExpressionBuilder

Vererbung: Object

ExpressionBuilder
ConnectionStringsExpressionBuilder

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie Ein Steuerelement deklarativ verwendet SqlDataSource wird, um Daten aus einem Computer abzurufen, auf dem Microsoft SQL Server ausgeführt wird, und es in einem GridView Steuerelement anzuzeigen.

<%@ Page Language="C#" %>

<!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>ASP.NET Example</title>
</head>
<body>
    <form id="form1" runat="server">

      <asp:SqlDataSource
          id="SqlDataSource1"
          runat="server"
          DataSourceMode="DataReader"
          ConnectionString="<%$ ConnectionStrings:MyNorthwind%>"
          SelectCommand="SELECT FirstName, LastName, Title FROM Employees">
      </asp:SqlDataSource>

      <asp:GridView
          id="GridView1"
          runat="server"
          DataSourceID="SqlDataSource1">
      </asp:GridView>

    </form>
  </body>
</html>

<%@ Page Language="VB" %>

<!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>ASP.NET Example</title>
</head>
<body>
    <form id="form1" runat="server">

      <asp:SqlDataSource
          id="SqlDataSource1"
          runat="server"
          DataSourceMode="DataReader"
          ConnectionString="<%$ ConnectionStrings:MyNorthwind%>"
          SelectCommand="SELECT FirstName, LastName, Title FROM Employees">
      </asp:SqlDataSource>

      <asp:GridView
          id="GridView1"
          runat="server"
          DataSourceID="SqlDataSource1">
      </asp:GridView>

    </form>
  </body>
</html>

Der Code ruft die folgende Verbindungszeichenfolge aus der Web.config-Datei ab.

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

<connectionStrings>

<add name="MyNorthwind" connectionString="Data

Source=localhost;Integrated Security=SSPI;Initial

Catalog=Northwind;" providerName="System.Data.SqlClient" />

</connectionStrings>

</configuration>

Hinweise

Die ConnectionStringsExpressionBuilder Klasse bietet Zugriff auf Werte im <connectionStrings> Abschnitt der Web.config-Datei. Der <connectionStrings> Abschnitt der Web.config-Datei enthält Verbindungszeichenfolgenwerte in Namen-/Wertpaaren.

Ein Verbindungszeichenfolgenwert wird abgerufen, indem ein Ausdruck des Formulars zugewiesen wird

<%$ ConnectionStrings: secureConnectionString %>

zu einer Steuerelementeigenschaft. Der Teil des Ausdrucks vor dem Doppelpunkt (:) gibt den Ausdruckstyp an, der abgerufen werden soll, und der Teil nach dem Doppelpunkt kennzeichnet den Namen der Verbindungszeichenfolge. Der vorherige Ausdruck würde den folgenden Wert aus der Web.config-Datei abrufen.

<connectionStrings>

<add name="secureConnectionString" connectionString="Data

Source=localhost;Integrated Security=SSPI;Initial

Catalog=Northwind;" providerName="System.Data.SqlClient" />

</connectionStrings>

Wenn der Seitenparser einen Ausdruck mit dem Präfix ConnectionStringsauftritt, erstellt er eine Instanz der ConnectionStringsExpressionBuilder Klasse, um den Ausdruck zu behandeln.

Wenn der Ausdruck in einer Seite gefunden wird, die kompiliert wird, generiert das ConnectionStringsExpressionBuilder Objekt Code, der die angegebene Verbindungszeichenfolge aus der Web.config-Datei abruft. Wenn der Ausdruck in einer Seite gefunden wird, die nicht kompiliert wird, gibt das ConnectionStringsExpressionBuilder Objekt den Wert aus der Web.config-Datei zurück, wenn die Seite analysiert wird.

Konstruktoren

ConnectionStringsExpressionBuilder()

Initialisiert eine neue Instanz der ConnectionStringsExpressionBuilder-Klasse.

Eigenschaften

SupportsEvaluate

Gibt einen Wert zurück, der angibt, ob ein Ausdruck in einer nicht kompilierten Seite ausgewertet werden kann.

Methoden

Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
EvaluateExpression(Object, BoundPropertyEntry, Object, ExpressionBuilderContext)	Gibt einen Wert aus dem <`connectionStrings`>-Abschnitt der Datei „Web.config“ zurück.
GetCodeExpression(BoundPropertyEntry, Object, ExpressionBuilderContext)	Gibt einen während der Seitenanalyse auszuwertenden Codeausdruck zurück.
GetConnectionString(String)	Gibt eine Verbindungszeichenfolge aus dem <`connectionStrings`>-Abschnitt der Datei „Web.config“ zurück.
GetConnectionStringProviderName(String)	Gibt den Anbieter der Verbindungszeichenfolge aus dem <`connectionStrings`>-Abschnitt der Datei „Web.config“ 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)
ParseExpression(String, Type, ExpressionBuilderContext)	Gibt ein Objekt zurück, das den analysierten Ausdruck darstellt.
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)

Gilt für