ConnectionStringsExpressionBuilder Classe

  • Referência

Definição

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

Recupera ou gera o código a ser recuperado, valores da seção <connectionStrings> do arquivo 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
Herança
Object
ExpressionBuilder
ConnectionStringsExpressionBuilder

Exemplos

O exemplo de código a seguir demonstra como usar declarativamente um SqlDataSource controle para recuperar dados de um computador que executa o Microsoft SQL Server e exibi-los em um GridView controle .

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

O código recupera a cadeia de conexão a seguir do arquivo 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>

Comentários

A ConnectionStringsExpressionBuilder classe fornece acesso a valores na <connectionStrings> seção do arquivo Web.config. A <connectionStrings> seção do arquivo Web.config contém valores de cadeia de conexão em pares nome/valor.

Um valor de cadeia de conexão é recuperado atribuindo uma expressão do formulário

<%$ ConnectionStrings: secureConnectionString %>

para uma propriedade de controle. A parte da expressão antes dos dois-pontos (:) designa o tipo de expressão a ser recuperada e a parte após os dois-pontos significa o nome da cadeia de conexão. A expressão anterior recuperaria o valor a seguir do arquivo Web.config.

<connectionStrings>

<add name="secureConnectionString" connectionString="Data

Source=localhost;Integrated Security=SSPI;Initial

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

</connectionStrings>

Quando o analisador de página encontra uma expressão com o prefixo ConnectionStrings, ele cria uma instância da ConnectionStringsExpressionBuilder classe para manipular a expressão.

Se a expressão for encontrada em uma página que será compilada, o objeto gerará o ConnectionStringsExpressionBuilder código que recupera a cadeia de conexão especificada do arquivo Web.config. Se a expressão for encontrada em uma página que não será compilada, o ConnectionStringsExpressionBuilder objeto retornará o valor do arquivo Web.config quando a página for analisada.

Construtores

ConnectionStringsExpressionBuilder()

Inicializa uma nova instância da classe ConnectionStringsExpressionBuilder.

Propriedades

SupportsEvaluate

Retorna um valor que indica se uma expressão pode ser avaliada em uma página não compilada.

Métodos

Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

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

Retorna um valor da seção <connectionStrings> do arquivo Web.config.
GetCodeExpression(BoundPropertyEntry, Object, ExpressionBuilderContext)

Retorna uma expressão de código a ser avaliada durante a análise da página.
GetConnectionString(String)

Retorna uma cadeia de conexão da seção <connectionStrings> do arquivo Web.config.
GetConnectionStringProviderName(String)

Retorna o provedor da cadeia de conexão da seção <connectionStrings> do arquivo Web.config.
GetHashCode()

Serve como a função de hash padrão.

(Herdado de Object)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
MemberwiseClone()

Cria uma cópia superficial do Object atual.

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

Retorna um objeto que representa a expressão analisada.
ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.

(Herdado de Object)

Aplica-se a

Confira também