SqlDataSource.ConnectionString Proprietà

  • Riferimento

Definizione

Spazio dei nomi:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Ottiene o imposta la stringa di connessione specifica del provider ADO.NET utilizzata dal controllo SqlDataSource per connettersi a un database sottostante.

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

Valore della proprietà

String

Stringa specifica del provider di dati di .NET Framework usata dall'SqlDataSource per connettersi al database SQL rappresentato. Il valore predefinito è una stringa vuota ("").

Esempio

Nell'esempio di codice seguente viene illustrato come impostare la proprietà ConnectionString per connettersi a un database di SQL Server e visualizzare i risultati della proprietà SelectCommand in un controllo 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>

Commenti

Il controllo SqlDataSource può essere usato con un'ampia gamma di provider di ADO.NET e la sintassi della stringa di connessione usata per connettersi a un'origine dati sottostante è specifica per il provider.

Quando si configura un controllo SqlDataSource, si imposta la proprietà ProviderName sul tipo di database (il valore predefinito è System.Data.SqlClient) e si imposta la proprietà ConnectionString su una stringa di connessione che include informazioni necessarie per connettersi al database. Il contenuto di una stringa di connessione varia a seconda del tipo di database a cui accede il controllo origine dati. Ad esempio, il controllo SqlDataSource richiede un nome del server, un nome di database (catalogo) e informazioni su come autenticare l'utente durante la connessione a SQL Server. Per informazioni sul contenuto delle stringhe di connessione, vedere la proprietà ConnectionString per la classe SqlConnection, la proprietà ConnectionString per la classe OracleConnection, la proprietà ConnectionString per la classe OleDbConnection o la proprietà ConnectionString per la classe OdbcConnection.

Se si modifica la proprietà ConnectionString, viene generato l'evento DataSourceChanged, causando la riassociazione di tutti i controlli associati al controllo SqlDataSource.

Importante

Per informazioni sull'archiviazione di una stringa di connessione, vedere Procedura: Proteggere le stringhe di connessione quando si usano i controlli origine dati.

Si applica a

Vedi anche