通过

SqlDataSource.ConnectionString 属性

  • 参考

定义

命名空间:
System.Web.UI.WebControls
程序集:
System.Web.dll

获取或设置 SqlDataSource 控件用于连接到基础数据库的 ADO.NET 特定于提供程序的连接字符串。

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

属性值

String

SqlDataSource 用来连接到它所表示的 SQL 数据库的 .NET Framework 数据提供程序特定的字符串。 默认值为空字符串（“）。

示例

下面的代码示例演示如何设置 ConnectionString 属性以连接到 SQL Server 数据库，并在 GridView 控件中显示 SelectCommand 属性的结果。

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

注解

SqlDataSource 控件可用于各种 ADO.NET 提供程序，以及用于连接到基础数据源的连接字符串的语法特定于提供程序。

配置 SqlDataSource 控件时，将 ProviderName 属性设置为数据库类型（默认值为 System.Data.SqlClient），并将 ConnectionString 属性设置为包含连接到数据库所需的信息的连接字符串。 连接字符串的内容因数据源控件访问的数据库类型而异。 例如，SqlDataSource 控件需要服务器名称、数据库（目录）名称和有关如何在连接到 SQL Server 时对用户进行身份验证的信息。 有关连接字符串内容的信息，请参阅 SqlConnection 类的 ConnectionString 属性、OracleConnection 类的 ConnectionString 属性、OleDbConnection 类的 ConnectionString 属性或 OdbcConnection 类的 ConnectionString 属性。

如果更改 ConnectionString 属性，则会引发 DataSourceChanged 事件，导致绑定到 SqlDataSource 控件的任何控件重新绑定。

重要

有关存储连接字符串的信息，请参阅 如何使用数据源控件时保护连接字符串。

适用于

另请参阅