SqlDataSource.ConnectionString Özellik

  • Başvuru

Tanım

Ad Alanı:
System.Web.UI.WebControls
Bütünleştirilmiş Kod:
System.Web.dll

SqlDataSource denetiminin temel alınan veritabanına bağlanmak için kullandığı sağlayıcıya özgü ADO.NET bağlantı dizesini alır veya ayarlar.

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

Özellik Değeri

String

SqlDataSource temsil ettiği SQL veritabanına bağlanmak için kullandığı .NET Framework veri sağlayıcısına özgü bir dize. Varsayılan değer boş bir dizedir ("").

Örnekler

Aşağıdaki kod örneği, bir SQL Server veritabanına bağlanmak ve SelectCommand özelliğinin sonuçlarını bir GridView denetiminde görüntülemek için ConnectionString özelliğinin nasıl ayarlandığını gösterir.

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

Açıklamalar

SqlDataSource denetimi çeşitli ADO.NET sağlayıcılarıyla kullanılabilir ve temel alınan veri kaynağına bağlanmak için kullanılan bağlantı dizesinin söz dizimi sağlayıcıya özgüdür.

bir SqlDataSource denetimi yapılandırırken, ProviderName özelliğini veritabanı türüne ayarlarsınız (varsayılan değer System.Data.SqlClient) ve ConnectionString özelliğini veritabanına bağlanmak için gerekli bilgileri içeren bir bağlantı dizesine ayarlarsınız. Bağlantı dizesinin içeriği, veri kaynağı denetiminin eriştiği veritabanı türüne bağlı olarak değişir. Örneğin, SqlDataSource denetimi bir sunucu adı, veritabanı (katalog) adı ve bir SQL Server'a bağlanırken kullanıcının kimliğini doğrulama hakkında bilgi gerektirir. Bağlantı dizelerinin içeriği hakkında bilgi için bkz. SqlConnection sınıfının ConnectionString özelliği, OracleConnection sınıfının ConnectionString özelliği, OleDbConnection sınıfının ConnectionString özelliği veya OdbcConnection sınıfının ConnectionString özelliği.

ConnectionString özelliğini değiştirirseniz, DataSourceChanged olayı tetiklenir ve SqlDataSource denetimine bağlı tüm denetimlerin yeniden bağlanmasına neden olur.

Önemli

Bağlantı dizesini depolama hakkında bilgi için bkz. Nasıl Yapılır: Veri Kaynağı Denetimlerini Kullanırken Bağlantı Dizelerinin Güvenliğini Sağlama.

Şunlara uygulanır

Ayrıca bkz.