ConnectionStringsExpressionBuilder Clase

Definición

Recupera o genera código para recuperar valores de la sección <connectionStrings> del archivo Web.config.

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
Herencia
ConnectionStringsExpressionBuilder

Ejemplos

En el ejemplo de código siguiente se muestra cómo usar mediante declaración un SqlDataSource control para recuperar datos de un equipo que ejecuta Microsoft SQL Server y mostrarlos en un GridView control .

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

El código recupera la siguiente cadena de conexión del archivo Web.config.

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

Comentarios

La ConnectionStringsExpressionBuilder clase proporciona acceso a los valores de la <connectionStrings> sección del archivo Web.config. La <connectionStrings> sección del archivo Web.config contiene valores de cadena de conexión en pares nombre-valor.

Se recupera un valor de cadena de conexión mediante la asignación de una expresión del formulario.

<%$ ConnectionStrings: secureConnectionString %>

a una propiedad de control. Parte de la expresión antes de los dos puntos (:) designa el tipo de expresión que se va a recuperar y la parte después de los dos puntos indica el nombre de la cadena de conexión. La expresión anterior recuperaría el siguiente valor del archivo Web.config.

<connectionStrings>

<add name="secureConnectionString" connectionString="Data

Source=localhost;Integrated Security=SSPI;Initial

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

</connectionStrings>

Cuando el analizador de páginas encuentra una expresión con el prefijo ConnectionStrings, crea una instancia de la ConnectionStringsExpressionBuilder clase para controlar la expresión.

Si la expresión se encuentra en una página que se compilará, el ConnectionStringsExpressionBuilder objeto genera código que recupera la cadena de conexión especificada del archivo Web.config. Si la expresión se encuentra en una página que no se compilará, el ConnectionStringsExpressionBuilder objeto devuelve el valor del archivo Web.config cuando se analiza la página.

Constructores

ConnectionStringsExpressionBuilder()

Inicializa una nueva instancia de la clase ConnectionStringsExpressionBuilder.

Propiedades

SupportsEvaluate

Devuelve un valor que indica si una expresión se puede evaluar en una página no compilada.

Métodos

Equals(Object)

Determina si el objeto especificado es igual que el objeto actual.

(Heredado de Object)
EvaluateExpression(Object, BoundPropertyEntry, Object, ExpressionBuilderContext)

Devuelve un valor de la sección <connectionStrings> del archivo Web.config.

GetCodeExpression(BoundPropertyEntry, Object, ExpressionBuilderContext)

Devuelve una expresión de código que se evaluará durante el análisis de páginas.

GetConnectionString(String)

Devuelve una cadena de conexión de la sección <connectionStrings> del archivo Web.config.

GetConnectionStringProviderName(String)

Devuelve el proveedor de cadena de conexión de la sección <connectionStrings> del archivo Web.config.

GetHashCode()

Sirve como la función hash predeterminada.

(Heredado de Object)
GetType()

Obtiene el Type de la instancia actual.

(Heredado de Object)
MemberwiseClone()

Crea una copia superficial del Object actual.

(Heredado de Object)
ParseExpression(String, Type, ExpressionBuilderContext)

Devuelve un objeto que representa la expresión analizada.

ToString()

Devuelve una cadena que representa el objeto actual.

(Heredado de Object)

Se aplica a

Consulte también