ConnectionStringsExpressionBuilder Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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
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. La 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 significa 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 < |
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 < |
GetConnectionStringProviderName(String) |
Devuelve el proveedor de cadena de conexión de la sección < |
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) |