SqlDataSource.ConnectionString Propriedade

Referência

Definição

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Obtém ou define a cadeia de conexão específica do provedor ADO.NET que o controle SqlDataSource usa para se conectar a um banco de dados subjacente.

public:
 virtual property System::String ^ ConnectionString { System::String ^ get(); void set(System::String ^ value); };

public virtual string ConnectionString { get; set; }

member this.ConnectionString : string with get, set

Public Overridable Property ConnectionString As String

Valor da propriedade

String

Uma cadeia de caracteres específica do provedor de dados do .NET Framework que o SqlDataSource usa para se conectar ao banco de dados SQL que ele representa. O padrão é uma cadeia de caracteres vazia ("").

Exemplos

O exemplo de código a seguir demonstra como definir a propriedade ConnectionString para se conectar a um banco de dados do SQL Server e exibir os resultados da propriedade SelectCommand em um controle GridView.

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

Comentários

O controle SqlDataSource pode ser usado com uma variedade de provedores de ADO.NET e a sintaxe da cadeia de conexão usada para se conectar a uma fonte de dados subjacente é específica para o provedor.

Ao configurar um controle de SqlDataSource, defina a propriedade ProviderName como o tipo de banco de dados (o padrão é System.Data.SqlClient) e defina a propriedade ConnectionString como uma cadeia de conexão que inclui informações necessárias para se conectar ao banco de dados. O conteúdo de uma cadeia de conexão difere dependendo do tipo de banco de dados que o controle da fonte de dados está acessando. Por exemplo, o controle SqlDataSource requer um nome de servidor, um nome de banco de dados (catálogo) e informações sobre como autenticar o usuário ao se conectar a um SQL Server. Para obter informações sobre o conteúdo das cadeias de conexão, consulte a propriedade ConnectionString da classe SqlConnection, ConnectionString propriedade para a classe OracleConnection, ConnectionString propriedade para a classe OleDbConnection ou a propriedade ConnectionString da classe OdbcConnection.

Se você alterar a propriedade ConnectionString, o evento DataSourceChanged será acionado, fazendo com que todos os controles associados ao controle SqlDataSource sejam reinvindados.

Importante

Para obter informações sobre como armazenar uma cadeia de conexão, consulte How To: Secure Connection Strings when Using Data Source Controls.

Aplica-se a

Confira também

ProviderName
controles do servidor Web de fonte de dados
Visão geral do controle do servidor Web SqlDataSource
Visão geral do ciclo de vida da página ASP.NET

Partilhar via