Sdílet prostřednictvím

SqlDataSource.ConnectionString Vlastnost

  • Reference

Definice

Obor názvů:
System.Web.UI.WebControls
Sestavení:
System.Web.dll

Získá nebo nastaví připojovací řetězec specifický pro ADO.NET zprostředkovatele, který ovládací prvek SqlDataSource používá pro připojení k podkladové databázi.

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

Hodnota vlastnosti

String

Řetězec specifické pro zprostředkovatele dat rozhraní .NET Framework, který SqlDataSource používá pro připojení k databázi SQL, kterou představuje. Výchozí hodnota je prázdný řetězec ("").

Příklady

Následující příklad kódu ukazuje, jak nastavit ConnectionString vlastnost pro připojení k databázi SQL Serveru a zobrazit výsledky SelectCommand vlastnost v ovládacím prvku 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>

Poznámky

Ovládací prvek SqlDataSource lze použít s různými poskytovateli ADO.NET a syntaxí připojovacího řetězce, který se používá pro připojení k podkladovému zdroji dat, je specifický pro daného poskytovatele.

Při konfiguraci ovládacího prvku SqlDataSource nastavíte vlastnost ProviderName na typ databáze (výchozí hodnota je System.Data.SqlClient) a vlastnost ConnectionString nastavíte na připojovací řetězec, který obsahuje informace potřebné k připojení k databázi. Obsah připojovacího řetězce se liší v závislosti na typu databáze, ke které má řízení zdrojů dat přístup. Například ovládací prvek SqlDataSource vyžaduje název serveru, název databáze (katalogu) a informace o tom, jak ověřit uživatele při připojování k SQL Serveru. Informace o obsahu připojovacích řetězců naleznete v ConnectionString vlastnost třídy SqlConnection, ConnectionString vlastnost pro třídu OracleConnection, ConnectionString vlastnost pro třídu OleDbConnection nebo vlastnost ConnectionString třídy OdbcConnection.

Pokud změníte vlastnost ConnectionString, vyvolá se událost DataSourceChanged, což způsobí, že všechny ovládací prvky vázané na ovládací prvek SqlDataSource se znovu propojí.

Důležitý

Informace o ukládání připojovacího řetězce najdete v tématu Postupy: Zabezpečení připojovacích řetězců při použití ovládacích prvků zdroje dat.

Platí pro

Viz také