SqlDataSource SqlDataSource SqlDataSource SqlDataSource Class

Definizione

Rappresenta un database di SQL nei controlli con associazione a dati.Represents an SQL database to data-bound controls.

public ref class SqlDataSource : System::Web::UI::DataSourceControl
[System.Drawing.ToolboxBitmap(typeof(System.Web.UI.WebControls.SqlDataSource))]
public class SqlDataSource : System.Web.UI.DataSourceControl
type SqlDataSource = class
    inherit DataSourceControl
Public Class SqlDataSource
Inherits DataSourceControl
Ereditarietà
Derivato
Attributi

Esempi

Questa sezione contiene quattro esempi di codice:This section contains four code examples:

  • Nel primo esempio di codice viene illustrato come visualizzare i dati da SQL Server GridView in un controllo utilizzando la sintassi dichiarativa.The first code example demonstrates how to display data from SQL Server in a GridView control using declarative syntax.

  • Nel secondo esempio di codice viene illustrato come visualizzare i dati da un database conforme a ODBC GridView in un controllo utilizzando la sintassi dichiarativa.The second code example demonstrates how to display data from an ODBC-compliant database in a GridView control using declarative syntax.

  • Nel terzo esempio di codice viene illustrato come visualizzare e aggiornare i dati GridView in un controllo.The third code example demonstrates how to display and update data in a GridView control.

  • Nel quarto esempio di codice viene illustrato come visualizzare e aggiornare i dati DropDownList in un controllo.The fourth code example demonstrates how to display and update data in a DropDownList control.

    Nota

    In questi esempi viene illustrato come utilizzare la sintassi dichiarativa per l'accesso ai dati.These examples show how to use declarative syntax for data access. Per informazioni su come accedere ai dati usando il codice anziché il markup, vedere accesso ai dati in Visual Studio.For information about how to access data by using code instead of markup, see Accessing data in Visual Studio.

Nell'esempio di codice riportato di seguito viene illustrato SqlDataSource come utilizzare un controllo in modo dichiarativo per recuperare dati da GridView SQL Server e visualizzarli in un controllo.The following code example demonstrates how to use a SqlDataSource control declaratively to retrieve data from SQL Server and display it in a GridView control.

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

Nell'esempio di codice riportato di seguito viene illustrato SqlDataSource come utilizzare un controllo in modo dichiarativo per recuperare dati da un database conforme a GridView ODBC e visualizzarli in un controllo.The following code example demonstrates how to use a SqlDataSource control declaratively to retrieve data from an ODBC-compliant database and display it in a GridView control. La ProviderName proprietà è il nome del .NET Framework provider di dati per ODBC, System.Data.Odbcovvero.The ProviderName property is the name of the .NET Framework Data Provider for ODBC, which is System.Data.Odbc.

<%@ 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>
    <!-- This example uses a Northwind database that is hosted by an ODBC-compliant
         database. To run this sample, create an ODBC DSN to any database that hosts
         the Northwind database, including Microsoft SQL Server or Microsoft Access,
         change the name of the DSN in the ConnectionString, and view the page.
    -->
    <form id="form1" runat="server">

      <asp:SqlDataSource
          id="SqlDataSource1"
          runat="server"
          ProviderName="System.Data.Odbc"
          DataSourceMode="DataReader"
          ConnectionString="dsn=myodbc3dsn;"
          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>
    <!-- This example uses a Northwind database that is hosted by an ODBC-compliant
         database. To run this sample, create an ODBC DSN to any database that hosts
         the Northwind database, including Microsoft SQL Server or Microsoft Access,
         change the name of the DSN in the ConnectionString, and view the page.
    -->
    <form id="form1" runat="server">

      <asp:SqlDataSource
          id="SqlDataSource1"
          runat="server"
          ProviderName="System.Data.Odbc"
          DataSourceMode="DataReader"
          ConnectionString="dsn=myodbc3dsn;"
          SelectCommand="SELECT FirstName, LastName, Title FROM Employees">
      </asp:SqlDataSource>

      <asp:GridView
          id="GridView1"
          runat="server"
          DataSourceID="SqlDataSource1">
      </asp:GridView>

    </form>
  </body>
</html>

Nell'esempio di codice riportato di seguito viene illustrato uno scenario di visualizzazione GridView e aggiornamento comune con il controllo.The following code example demonstrates a common display and update scenario with the GridView control. Come per gli esempi precedenti, i dati del database Northwind vengono visualizzati nel GridView controllo.As with the previous examples, data from the Northwind database is displayed in the GridView control. Inoltre, poiché viene UpdateCommand specificata una proprietà e la AutoGenerateEditButton proprietà è impostata su true, è possibile modificare e aggiornare i record senza codice aggiuntivo.Additionally, because an UpdateCommand property is specified and the AutoGenerateEditButton property is set to true, you can edit and update the records with no additional code. Il GridView controllo gestisce automaticamente l' UpdateParameters aggiunta di parametri alla raccolta e chiama Update il metodo quando si fa clic sul GridView pulsante Aggiorna nel controllo.The GridView control automatically handles adding parameters to the UpdateParameters collection and calls the Update method when the Update button in the GridView control is clicked.

<%@ 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="DataSet"
          ConnectionString="<%$ ConnectionStrings:MyNorthwind%>"
          SelectCommand="SELECT EmployeeID,FirstName,LastName,Title FROM Employees"
          UpdateCommand="Update Employees SET FirstName=@FirstName,LastName=@LastName,Title=@Title WHERE EmployeeID=@EmployeeID">
      </asp:SqlDataSource>

      <asp:GridView
          id="GridView1"
          runat="server"
          AutoGenerateColumns="False"
          DataKeyNames="EmployeeID"
          AutoGenerateEditButton="True"
          DataSourceID="SqlDataSource1">
          <columns>
              <asp:BoundField HeaderText="First Name" DataField="FirstName" />
              <asp:BoundField HeaderText="Last Name" DataField="LastName" />
              <asp:BoundField HeaderText="Title" DataField="Title" />
          </columns>

      </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="DataSet"
          ConnectionString="<%$ ConnectionStrings:MyNorthwind%>"
          SelectCommand="SELECT EmployeeID,FirstName,LastName,Title FROM Employees"
          UpdateCommand="Update Employees SET FirstName=@FirstName,LastName=@LastName,Title=@Title WHERE EmployeeID=@EmployeeID">
      </asp:SqlDataSource>

      <asp:GridView
          id="GridView1"
          runat="server"
          AutoGenerateColumns="False"
          DataKeyNames="EmployeeID"
          AutoGenerateEditButton="True"
          DataSourceID="SqlDataSource1">
          <columns>
              <asp:BoundField HeaderText="First Name" DataField="FirstName" />
              <asp:BoundField HeaderText="Last Name" DataField="LastName" />
              <asp:BoundField HeaderText="Title" DataField="Title" />
          </columns>

      </asp:GridView>
    </form>
  </body>
</html>

Nell'esempio di codice riportato di seguito viene illustrato uno scenario di visualizzazione DropDownList e TextBox aggiornamento comune con i controlli e.The following code example demonstrates a common display and update scenario with the DropDownList and TextBox controls. Il DropDownList controllo non aggiunge automaticamente i parametri UpdateParameters di aggiornamento alla raccolta, né chiama Update il metodo, pertanto è necessario eseguire questa operazione.The DropDownList control does not automatically add update parameters to the UpdateParameters collection nor call the Update method, so you must do so. I parametri di aggiornamento vengono specificati in modo dichiarativo ed è possibile aggiungere un gestore Update eventi per eseguire l'operazione quando viene generato un evento.The update parameters are specified declaratively and you can add an event handler to perform the Update operation when an event is raised.

Importante

Questo esempio include una casella di testo che accetta l'input dell'utente, che rappresenta una potenziale minaccia per la sicurezza.This example includes a text box that accepts user input, which is a potential security threat. Per impostazione predefinita, le pagine Web ASP.NET verificano che l'input dell'utente non includa script o elementi HTML.By default, ASP.NET Web pages validate that user input does not include script or HTML elements. Per altre informazioni, vedere Cenni preliminari sugli attacchi tramite script.For more information, see Script Exploits Overview.

<%@Page  Language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">
 private void On_Click(Object source, EventArgs e) {
    try {
        SqlDataSource1.Update();
    }
    catch (Exception except) {
        // Handle the Exception.
    }

    Label2.Text="The record was updated successfully!";
 }
</script>

<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"
          ConnectionString="<%$ ConnectionStrings:MyNorthwind%>"
          SelectCommand="SELECT EmployeeID, LastName, Address FROM Employees"
          UpdateCommand="UPDATE Employees SET Address=@Address WHERE EmployeeID=@EmployeeID">
          <UpdateParameters>
              <asp:ControlParameter Name="Address" ControlId="TextBox1" PropertyName="Text"/>
              <asp:ControlParameter Name="EmployeeID" ControlId="DropDownList1" PropertyName="SelectedValue"/>
          </UpdateParameters>
      </asp:SqlDataSource>

      <asp:DropDownList
          id="DropDownList1"
          runat="server"
          DataTextField="LastName"
          DataValueField="EmployeeID"
          DataSourceID="SqlDataSource1">
      </asp:DropDownList>

      <br />
      <asp:Label id="Label1" runat="server" Text="Enter a new address for the selected user."
        AssociatedControlID="TextBox1" />
      <asp:TextBox id="TextBox1" runat="server" />
      <asp:Button id="Submit" runat="server" Text="Submit" OnClick="On_Click" />

      <br /><asp:Label id="Label2" runat="server" Text="" />

    </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">

<script runat="server">

 Sub On_Click(ByVal source As Object, ByVal e As EventArgs)
    Try
        SqlDataSource1.Update()
    Catch except As Exception
        ' Handle the Exception.
    End Try

    Label2.Text="The record was updated successfully!"

 End Sub 'On_Click
</script>

<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"
          ConnectionString="<%$ ConnectionStrings:MyNorthwind%>"
          SelectCommand="SELECT EmployeeID, LastName, Address FROM Employees"
          UpdateCommand="UPDATE Employees SET Address=@Address WHERE EmployeeID=@EmployeeID">
          <UpdateParameters>
              <asp:ControlParameter Name="Address" ControlId="TextBox1" PropertyName="Text"/>
              <asp:ControlParameter Name="EmployeeID" ControlId="DropDownList1" PropertyName="SelectedValue"/>
          </UpdateParameters>
      </asp:SqlDataSource>

      <asp:DropDownList
          id="DropDownList1"
          runat="server"
          DataTextField="LastName"
          DataValueField="EmployeeID"
          DataSourceID="SqlDataSource1">
      </asp:DropDownList>

      <br />
      <asp:Label id="Label1" runat="server" Text="Enter a new address for the selected user."
        AssociatedControlID="TextBox1" />
      <asp:TextBox id="TextBox1" runat="server" />
      <asp:Button id="Submit" runat="server" Text="Submit" OnClick="On_Click" />

      <br /><asp:Label id="Label2" runat="server" Text="" />
    </form>
  </body>
</html>

Commenti

In questo argomentoIn this topic:

IntroduzioneIntroduction

Il SqlDataSource controllo origine dati rappresenta i dati in un database relazionale SQL per i controlli associati a dati.The SqlDataSource data source control represents data in an SQL relational database to data-bound controls. È possibile utilizzare il SqlDataSource controllo insieme a un controllo con associazione a dati per recuperare i dati da un database relazionale e per visualizzare, modificare e ordinare i dati in una pagina Web senza codice.You can use the SqlDataSource control in conjunction with a data-bound control to retrieve data from a relational database and to display, edit, and sort data on a Web page with little or no code.

Connessioni datiData Connections

Per connettersi a un database, è necessario impostare la ConnectionString proprietà su una stringa di connessione valida.To connect to a database, you must set the ConnectionString property to a valid connection string. OleDb SqlClient OracleClient OdbcPuò supportare qualsiasi database relazionale SQL che può essere connesso a utilizzando un provider ADO.NET, ad esempio il provider,, o. SqlDataSourceThe SqlDataSource can support any SQL relational database that can be connected to using an ADO.NET provider, such as the SqlClient, OleDb, Odbc, or OracleClient provider. Per informazioni su come proteggere le stringhe di connessione, vedere Procedura: Proteggere le stringhe di connessione quando si utilizzanoi controlli origine dati.For information about how to secure connection strings, see How To: Secure Connection Strings when Using Data Source Controls.

Per recuperare dati da un database sottostante, impostare la SelectCommand proprietà su una query SQL.To retrieve data from an underlying database, set the SelectCommand property with an SQL query. Se il database a cui SqlDataSource è associato supporta le stored procedure, è possibile impostare la SelectCommand proprietà sul nome di un stored procedure.If the database that the SqlDataSource is associated with supports stored procedures, you can set the SelectCommand property to the name of a stored procedure. La query SQL specificata può essere anche una query con parametri.The SQL query that you specify can also be a parameterized query. È possibile aggiungere Parameter SelectParameters alla raccolta gli oggetti associati a una query con parametri.You can add Parameter objects that are associated with a parameterized query to the SelectParameters collection. Per ulteriori informazioni sulle query SQL con parametri e sulla relativa sintassi, vedere utilizzo di parametri con i controlli origine dati per l'applicazione di filtri.For more information about parameterized SQL queries and their syntax, see Using Parameters with Data Source Controls for Filtering.

Il SqlDataSource controllo Recupera i dati ogni Select volta che viene chiamato il metodo.The SqlDataSource control retrieves data whenever the Select method is called. Questo metodo fornisce l'accesso programmatico al metodo specificato dalla SelectMethod proprietà.This method provides programmatic access to the method that is specified by SelectMethod property. Il Select metodo viene chiamato automaticamente dai controlli associati SqlDataSource a quando DataBind viene chiamato il metodo.The Select method is automatically called by controls that are bound to the SqlDataSource when their DataBind method is called. Se si imposta la DataSourceID proprietà di un controllo associato a dati, il controllo si associa automaticamente ai dati dell'origine dati, in base alle esigenze.If you set the DataSourceID property of a data-bound control, the control automatically binds to data from the data source, as required. L'impostazione DataSourceID della proprietà è il metodo consigliato per l' ObjectDataSource associazione di un controllo a un controllo con associazione a dati.Setting the DataSourceID property is the recommended method for binding an ObjectDataSource control to a data-bound control. In alternativa, è possibile usare la DataSource proprietà, ma è necessario chiamare in modo esplicito DataBind il metodo del controllo con associazione a dati.Alternatively, you can use the DataSource property, but then you must explicitly call the DataBind method of the data-bound control. Alcuni esempi di controlli con associazione a dati che possono SqlDataSource essere DataGridusati DetailsViewsono DataList,, DropDownListe.Some examples of data-bound controls that can use SqlDataSource are DataGrid, DetailsView, DataList, and DropDownList. È possibile chiamare il Select metodo a livello di codice in qualsiasi momento per recuperare i dati dal database sottostante.You can call the Select method programmatically at any time to retrieve data from the underlying database.

Negli scenari ASP.NET dichiarativi e a livello di codice DataSourceID , è possibile impostare la proprietà del controllo con associazione a dati SqlDataSource sull'ID del controllo.In declarative and programmatic ASP.NET scenarios, you can set the DataSourceID property of the data-bound control to the ID of the SqlDataSource control. È inoltre possibile assegnare un'istanza della SqlDataSource classe DataSource alla proprietà del controllo associato a dati.You can also assign an instance of the SqlDataSource class to the DataSource property of the data-bound control. Per ulteriori informazioni sull'associazione di un controllo associato a dati ai controlli origine dati, vedere Opzioni di accesso ai dati ASP.NET.For more information about binding data-bound control to data source controls, see ASP.NET Data Access Options.

Esecuzione di operazioni sui datiPerforming Data Operations

A seconda delle funzionalità del prodotto del database sottostante e della configurazione dell'istanza della SqlDataSource classe, è possibile eseguire operazioni sui dati, ad esempio aggiornamenti, inserimenti ed eliminazioni.Depending on the capabilities of the underlying database product and the configuration of the instance of the SqlDataSource class, you can perform data operations, such as updates, inserts, and deletes. Per eseguire queste operazioni sui dati, impostare il testo del comando appropriato ed eventuali parametri associati per l'operazione che si desidera eseguire.To perform these data operations, set the appropriate command text and any associated parameters for the operation that you want to perform. Per un'operazione di aggiornamento, ad esempio, impostare UpdateCommand la proprietà su una stringa SQL o il nome di un stored procedure e aggiungere eventuali parametri richiesti UpdateParameters alla raccolta.For example, for an update operation, set the UpdateCommand property to an SQL string or the name of a stored procedure and add any required parameters to the UpdateParameters collection. L'aggiornamento viene eseguito quando viene Update chiamato il metodo, in modo esplicito dal codice o automaticamente da un controllo con associazione a dati.The update is performed when the Update method is called, either explicitly by your code or automatically by a data-bound control. Lo stesso modello generale viene seguito per Delete le Insert operazioni e.The same general pattern is followed for Delete and Insert operations.

È possibile parametrizzare le query e i comandi SQL SelectCommandutilizzati UpdateCommandnelle InsertCommandproprietà, DeleteCommand , e.The SQL queries and commands that you use in the SelectCommand, UpdateCommand, InsertCommand, and DeleteCommand properties can be parameterized. Ciò significa che la query o il comando può utilizzare segnaposto anziché valori letterali e associare i segnaposto alle variabili definite dall'utente o dall'applicazione.This means that the query or command can use placeholders instead of literal values and bind the placeholders to application or user-defined variables. È possibile associare parametri nelle query SQL alle variabili di sessione, i valori passati nella stringa di query per una pagina Web Form, i valori delle proprietà di altri controlli server e altro ancora.You can bind parameters in SQL queries to Session variables, values that are passed on the query string for a Web Forms page, the property values of other server controls, and more. Per ulteriori informazioni sull'utilizzo dei SqlDataSourceparametri nelle query SQL con, vedere Utilizzo di parametri con i controlli origine dati per filtrare e utilizzare parametri con il controllo SqlDataSource.For more information about how to use parameters in SQL queries with the SqlDataSource, see Using Parameters with Data Source Controls for Filtering and Using Parameters with the SqlDataSource Control.

Nota

Per impostazione predefinita, se uno dei parametri è null quando si esegue un Select comando, non verrà restituito alcun dato e non verrà generata alcuna eccezione.By default, if one of the parameters is null when you execute a Select command, no data will be returned and no exception will be thrown. È possibile modificare questo comportamento impostando la CancelSelectOnNullParameter proprietà su false.You can change this behavior by setting the CancelSelectOnNullParameter property to false.

provider di datiData Provider

Per impostazione predefinita, SqlDataSource il controllo funziona con il .NET Framework provider di dati per SQL Server, SqlDataSource ma non è specifico per Microsoft SQL Server.By default, the SqlDataSource control works with the .NET Framework Data Provider for SQL Server, but SqlDataSource is not Microsoft SQL Server-specific. È possibile connettere il SqlDataSource controllo a qualsiasi prodotto di database per il quale è disponibile un provider ADO.NET gestito.You can connect the SqlDataSource control with any database product for which there is a managed ADO.NET provider. Quando viene usato con System.Data.OleDb il provider SqlDataSource , può funzionare con qualsiasi database conforme a OLE DB.When used with the System.Data.OleDb provider, the SqlDataSource can work with any OLE DB-compliant database. Quando viene usato con System.Data.Odbc il provider SqlDataSource , può essere usato con qualsiasi database e driver ODBC, inclusi IBM DB2, MySQL e PostgreSQL.When used with the System.Data.Odbc provider, the SqlDataSource can be used with any ODBC driver and database, including IBM DB2, MySQL, and PostgreSQL. Quando viene usato con System.Data.OracleClient il provider SqlDataSource , può funzionare con i database Oracle 8.1.7 e versioni successive.When used with the System.Data.OracleClient provider, the SqlDataSource can work with Oracle 8.1.7 databases and later. L'elenco dei provider consentiti viene registrato nella DbProviderFactories sezione del file di configurazione, nel file Machine. config o Web. config.The list of allowable providers is registered in the DbProviderFactories section of the configuration file, either in the Machine.config or Web.config file. Per ulteriori informazioni, vedere selezione dei dati tramite il controllo SqlDataSource.For more information, see Selecting Data Using the SqlDataSource Control.

Memorizzazione nella cacheCaching

Se si visualizzano i dati nella pagina utilizzando SqlDataSource un controllo, è possibile aumentare le prestazioni della pagina utilizzando le funzionalità di memorizzazione nella cache dei dati del controllo origine dati.If you display data on your page using a SqlDataSource control, you can increase the performance of the page by using the data caching capabilities of the data source control. La memorizzazione nella cache consente di ridurre il carico di elaborazione sui server di database a scapito della memoria del server Web. nella maggior parte dei casi, si tratta di un compromesso valido.Caching reduces the processing load on the database servers at the expense of memory on the Web server; in most cases, this is a good trade-off. I SqlDataSource dati vengono automaticamente memorizzati nella cache EnableCaching quando la proprietà è true impostata su CacheDuration e la proprietà viene impostata sul numero di secondi durante i quali la cache archivia i dati prima che la voce della cache venga eliminata.The SqlDataSource automatically caches data when the EnableCaching property is set to true and the CacheDuration property is set to the number of seconds that the cache stores data before the cache entry is discarded. È anche possibile specificare un CacheExpirationPolicy valore e un SqlCacheDependency valore facoltativo.You can also specify a CacheExpirationPolicy and an optional SqlCacheDependency value.

Funzionalità aggiuntiveAdditional Features

SqlDataSource Fornisce funzionalità aggiuntive, elencate nella tabella seguente.The SqlDataSource provides additional capabilities, as listed in the following table.

FunzionalitàCapability RequisitiRequirements
Memorizzazione nella cacheCaching Impostare la DataSourceMode DataSet proprietà sul valore, la EnableCaching proprietà su truee le CacheDuration proprietà e CacheExpirationPolicy in base al comportamento di memorizzazione nella cache desiderato per i dati memorizzati nella cache.Set the DataSourceMode property to the DataSet value, the EnableCaching property to true, and the CacheDuration and CacheExpirationPolicy properties according to the caching behavior you want for your cached data.
EliminazioneDeleting Impostare la DeleteCommand proprietà su un'istruzione SQL utilizzata per eliminare i dati.Set the DeleteCommand property to an SQL statement used to delete data. Questa istruzione viene in genere parametrizzata.This statement is typically parameterized.
FiltroFiltering Impostare la DataSourceMode proprietà DataSet sul valore.Set the DataSourceMode property to the DataSet value. Impostare la FilterExpression proprietà su un'espressione di filtro usata per filtrare i dati quando Select viene chiamato il metodo.Set the FilterExpression property to a filtering expression used to filter the data when the Select method is called.
InserimentoInserting Impostare la InsertCommand proprietà su un'istruzione SQL utilizzata per inserire i dati.Set the InsertCommand property to an SQL statement used to insert data. Questa istruzione viene in genere parametrizzata.This statement is typically parameterized.
PagingPaging Attualmente SqlDataSourcenon supportato da, tuttavia alcuni controlli associati a dati, GridViewad esempio, supportano il paging quando si DataSet imposta la DataSourceMode proprietà sul valore.Not currently supported by the SqlDataSource, however some data-bound controls, such as GridView, support paging when you set the DataSourceMode property to the DataSet value.
SelezioneSelecting Impostare la SelectCommand proprietà su un'istruzione SQL utilizzata per recuperare i dati.Set the SelectCommand property to an SQL statement used to retrieve data.
OrdinamentoSorting Impostare la proprietà DataSourceMode su DataSet.Set the DataSourceMode property to DataSet.
UpdatingUpdating Impostare la UpdateCommand proprietà su un'istruzione SQL utilizzata per aggiornare i dati.Set the UpdateCommand property to an SQL statement used to update data. Questa istruzione viene in genere parametrizzata.This statement is typically parameterized.

Vista origine datiData Source View

Come per tutti i controlli origine dati, SqlDataSource il controllo è associato a una classe della vista origine dati.As with all data source controls, the SqlDataSource control is associated with a data source view class. Al SqlDataSource controllo è associato un solo SqlDataSourceViewoggetto ed è sempre denominato Table.The SqlDataSource control has only one associated SqlDataSourceView, and it is always named Table.

Non è disponibile alcun rendering visivo del SqlDataSource controllo, che viene implementato come controllo in modo che sia possibile crearlo in modo dichiarativo e, facoltativamente, consentirne la partecipazione alla gestione dello stato.There is no visual rendering of the SqlDataSource control; it is implemented as a control so that you can create it declaratively and, optionally, to allow it to participate in state management. Di conseguenza, non supporta SqlDataSource le funzionalità visive, ad esempio quelle fornite EnableTheming dalla proprietà o SkinID .As a result, the SqlDataSource does not support visual features, such as the ones that are provided by the EnableTheming or SkinID property.

Sintassi dichiarativaDeclarative Syntax

<asp:SqlDataSource  
    CacheDuration="string|Infinite"  
    CacheExpirationPolicy="Absolute|Sliding"  
    CacheKeyDependency="string"  
    CancelSelectOnNullParameter="True|False"  
    ConflictDetection="OverwriteChanges|CompareAllValues"  
    ConnectionString="string"  
    DataSourceMode="DataReader|DataSet"  
    DeleteCommand="string"  
    DeleteCommandType="Text|StoredProcedure"  
    EnableCaching="True|False"  
    EnableTheming="True|False"  
    EnableViewState="True|False"  
    FilterExpression="string"  
    ID="string"  
    InsertCommand="string"  
    InsertCommandType="Text|StoredProcedure"  
    OldValuesParameterFormatString="string"  
    OnDataBinding="DataBinding event handler"  
    OnDeleted="Deleted event handler"  
    OnDeleting="Deleting event handler"  
    OnDisposed="Disposed event handler"  
    OnFiltering="Filtering event handler"  
    OnInit="Init event handler"  
    OnInserted="Inserted event handler"  
    OnInserting="Inserting event handler"  
    OnLoad="Load event handler"  
    OnPreRender="PreRender event handler"  
    OnSelected="Selected event handler"  
    OnSelecting="Selecting event handler"  
    OnUnload="Unload event handler"  
    OnUpdated="Updated event handler"  
    OnUpdating="Updating event handler"  
    ProviderName="string|System.Data.Odbc|System.Data.OleDb|  
        System.Data.OracleClient|System.Data.SqlClient|  
        Microsoft.SqlServerCe.Client"  
    runat="server"  
    SelectCommand="string"  
    SelectCommandType="Text|StoredProcedure"  
    SkinID="string"  
    SortParameterName="string"  
    SqlCacheDependency="string"  
    UpdateCommand="string"  
    UpdateCommandType="Text|StoredProcedure"  
    Visible="True|False"  
>  
        <DeleteParameters>  
                <asp:ControlParameter  
                    ControlID="string"  
                    ConvertEmptyStringToNull="True|False"  
                    DefaultValue="string"  
                    Direction="Input|Output|InputOutput|ReturnValue"  
                    Name="string"  
                    PropertyName="string"  
                    Size="integer"  
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|  
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|  
                        Single|Double|Decimal|DateTime|String"  
                />  
                <asp:CookieParameter  
                    ConvertEmptyStringToNull="True|False"  
                    CookieName="string"  
                    DefaultValue="string"  
                    Direction="Input|Output|InputOutput|ReturnValue"  
                    Name="string"  
                    Size="integer"  
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|  
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|  
                        Single|Double|Decimal|DateTime|String"  
                />  
                <asp:FormParameter  
                    ConvertEmptyStringToNull="True|False"  
                    DefaultValue="string"  
                    Direction="Input|Output|InputOutput|ReturnValue"  
                    FormField="string"  
                    Name="string"  
                    Size="integer"  
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|  
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|  
                        Single|Double|Decimal|DateTime|String"  
                />  
                <asp:Parameter  
                    ConvertEmptyStringToNull="True|False"  
                    DefaultValue="string"  
                    Direction="Input|Output|InputOutput|ReturnValue"  
                    Name="string"  
                    Size="integer"  
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|  
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|  
                        Single|Double|Decimal|DateTime|String"  
                />  
                <asp:ProfileParameter  
                    ConvertEmptyStringToNull="True|False"  
                    DefaultValue="string"  
                    Direction="Input|Output|InputOutput|ReturnValue"  
                    Name="string"  
                    PropertyName="string"  
                    Size="integer"  
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|  
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|  
                        Single|Double|Decimal|DateTime|String"  
                />  
                <asp:QueryStringParameter  
                    ConvertEmptyStringToNull="True|False"  
                    DefaultValue="string"  
                    Direction="Input|Output|InputOutput|ReturnValue"  
                    Name="string"  
                    QueryStringField="string"  
                    Size="integer"  
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|  
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|  
                        Single|Double|Decimal|DateTime|String"  
                />  
                <asp:SessionParameter  
                    ConvertEmptyStringToNull="True|False"  
                    DefaultValue="string"  
                    Direction="Input|Output|InputOutput|ReturnValue"  
                    Name="string"  
                    SessionField="string"  
                    Size="integer"  
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|  
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|  
                        Single|Double|Decimal|DateTime|String"  
                />  
        </DeleteParameters>  
        <FilterParameters>  
                <asp:ControlParameter  
                    ControlID="string"  
                    ConvertEmptyStringToNull="True|False"  
                    DefaultValue="string"  
                    Direction="Input|Output|InputOutput|ReturnValue"  
                    Name="string"  
                    PropertyName="string"  
                    Size="integer"  
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|  
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|  
                        Single|Double|Decimal|DateTime|String"  
                />  
                <asp:CookieParameter  
                    ConvertEmptyStringToNull="True|False"  
                    CookieName="string"  
                    DefaultValue="string"  
                    Direction="Input|Output|InputOutput|ReturnValue"  
                    Name="string"  
                    Size="integer"  
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|  
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|  
                        Single|Double|Decimal|DateTime|String"  
                />  
                <asp:FormParameter  
                    ConvertEmptyStringToNull="True|False"  
                    DefaultValue="string"  
                    Direction="Input|Output|InputOutput|ReturnValue"  
                    FormField="string"  
                    Name="string"  
                    Size="integer"  
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|  
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|  
                        Single|Double|Decimal|DateTime|String"  
                />  
                <asp:Parameter  
                    ConvertEmptyStringToNull="True|False"  
                    DefaultValue="string"  
                    Direction="Input|Output|InputOutput|ReturnValue"  
                    Name="string"  
                    Size="integer"  
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|  
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|  
                        Single|Double|Decimal|DateTime|String"  
                />  
                <asp:ProfileParameter  
                    ConvertEmptyStringToNull="True|False"  
                    DefaultValue="string"  
                    Direction="Input|Output|InputOutput|ReturnValue"  
                    Name="string"  
                    PropertyName="string"  
                    Size="integer"  
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|  
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|  
                        Single|Double|Decimal|DateTime|String"  
                />  
                <asp:QueryStringParameter  
                    ConvertEmptyStringToNull="True|False"  
                    DefaultValue="string"  
                    Direction="Input|Output|InputOutput|ReturnValue"  
                    Name="string"  
                    QueryStringField="string"  
                    Size="integer"  
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|  
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|  
                        Single|Double|Decimal|DateTime|String"  
                />  
                <asp:SessionParameter  
                    ConvertEmptyStringToNull="True|False"  
                    DefaultValue="string"  
                    Direction="Input|Output|InputOutput|ReturnValue"  
                    Name="string"  
                    SessionField="string"  
                    Size="integer"  
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|  
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|  
                        Single|Double|Decimal|DateTime|String"  
                />  
        </FilterParameters>  
        <InsertParameters>  
                <asp:ControlParameter  
                    ControlID="string"  
                    ConvertEmptyStringToNull="True|False"  
                    DefaultValue="string"  
                    Direction="Input|Output|InputOutput|ReturnValue"  
                    Name="string"  
                    PropertyName="string"  
                    Size="integer"  
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|  
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|  
                        Single|Double|Decimal|DateTime|String"  
                />  
                <asp:CookieParameter  
                    ConvertEmptyStringToNull="True|False"  
                    CookieName="string"  
                    DefaultValue="string"  
                    Direction="Input|Output|InputOutput|ReturnValue"  
                    Name="string"  
                    Size="integer"  
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|  
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|  
                        Single|Double|Decimal|DateTime|String"  
                />  
                <asp:FormParameter  
                    ConvertEmptyStringToNull="True|False"  
                    DefaultValue="string"  
                    Direction="Input|Output|InputOutput|ReturnValue"  
                    FormField="string"  
                    Name="string"  
                    Size="integer"  
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|  
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|  
                        Single|Double|Decimal|DateTime|String"  
                />  
                <asp:Parameter  
                    ConvertEmptyStringToNull="True|False"  
                    DefaultValue="string"  
                    Direction="Input|Output|InputOutput|ReturnValue"  
                    Name="string"  
                    Size="integer"  
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|  
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|  
                        Single|Double|Decimal|DateTime|String"  
                />  
                <asp:ProfileParameter  
                    ConvertEmptyStringToNull="True|False"  
                    DefaultValue="string"  
                    Direction="Input|Output|InputOutput|ReturnValue"  
                    Name="string"  
                    PropertyName="string"  
                    Size="integer"  
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|  
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|  
                        Single|Double|Decimal|DateTime|String"  
                />  
                <asp:QueryStringParameter  
                    ConvertEmptyStringToNull="True|False"  
                    DefaultValue="string"  
                    Direction="Input|Output|InputOutput|ReturnValue"  
                    Name="string"  
                    QueryStringField="string"  
                    Size="integer"  
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|  
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|  
                        Single|Double|Decimal|DateTime|String"  
                />  
                <asp:SessionParameter  
                    ConvertEmptyStringToNull="True|False"  
                    DefaultValue="string"  
                    Direction="Input|Output|InputOutput|ReturnValue"  
                    Name="string"  
                    SessionField="string"  
                    Size="integer"  
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|  
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|  
                        Single|Double|Decimal|DateTime|String"  
                />  
        </InsertParameters>  
        <SelectParameters>  
                <asp:ControlParameter  
                    ControlID="string"  
                    ConvertEmptyStringToNull="True|False"  
                    DefaultValue="string"  
                    Direction="Input|Output|InputOutput|ReturnValue"  
                    Name="string"  
                    PropertyName="string"  
                    Size="integer"  
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|  
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|  
                        Single|Double|Decimal|DateTime|String"  
                />  
                <asp:CookieParameter  
                    ConvertEmptyStringToNull="True|False"  
                    CookieName="string"  
                    DefaultValue="string"  
                    Direction="Input|Output|InputOutput|ReturnValue"  
                    Name="string"  
                    Size="integer"  
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|  
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|  
                        Single|Double|Decimal|DateTime|String"  
                />  
                <asp:FormParameter  
                    ConvertEmptyStringToNull="True|False"  
                    DefaultValue="string"  
                    Direction="Input|Output|InputOutput|ReturnValue"  
                    FormField="string"  
                    Name="string"  
                    Size="integer"  
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|  
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|  
                        Single|Double|Decimal|DateTime|String"  
                />  
                <asp:Parameter  
                    ConvertEmptyStringToNull="True|False"  
                    DefaultValue="string"  
                    Direction="Input|Output|InputOutput|ReturnValue"  
                    Name="string"  
                    Size="integer"  
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|  
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|  
                        Single|Double|Decimal|DateTime|String"  
                />  
                <asp:ProfileParameter  
                    ConvertEmptyStringToNull="True|False"  
                    DefaultValue="string"  
                    Direction="Input|Output|InputOutput|ReturnValue"  
                    Name="string"  
                    PropertyName="string"  
                    Size="integer"  
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|  
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|  
                        Single|Double|Decimal|DateTime|String"  
                />  
                <asp:QueryStringParameter  
                    ConvertEmptyStringToNull="True|False"  
                    DefaultValue="string"  
                    Direction="Input|Output|InputOutput|ReturnValue"  
                    Name="string"  
                    QueryStringField="string"  
                    Size="integer"  
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|  
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|  
                        Single|Double|Decimal|DateTime|String"  
                />  
                <asp:SessionParameter  
                    ConvertEmptyStringToNull="True|False"  
                    DefaultValue="string"  
                    Direction="Input|Output|InputOutput|ReturnValue"  
                    Name="string"  
                    SessionField="string"  
                    Size="integer"  
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|  
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|  
                        Single|Double|Decimal|DateTime|String"  
                />  
        </SelectParameters>  
        <UpdateParameters>  
                <asp:ControlParameter  
                    ControlID="string"  
                    ConvertEmptyStringToNull="True|False"  
                    DefaultValue="string"  
                    Direction="Input|Output|InputOutput|ReturnValue"  
                    Name="string"  
                    PropertyName="string"  
                    Size="integer"  
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|  
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|  
                        Single|Double|Decimal|DateTime|String"  
                />  
                <asp:CookieParameter  
                    ConvertEmptyStringToNull="True|False"  
                    CookieName="string"  
                    DefaultValue="string"  
                    Direction="Input|Output|InputOutput|ReturnValue"  
                    Name="string"  
                    Size="integer"  
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|  
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|  
                        Single|Double|Decimal|DateTime|String"  
                />  
                <asp:FormParameter  
                    ConvertEmptyStringToNull="True|False"  
                    DefaultValue="string"  
                    Direction="Input|Output|InputOutput|ReturnValue"  
                    FormField="string"  
                    Name="string"  
                    Size="integer"  
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|  
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|  
                        Single|Double|Decimal|DateTime|String"  
                />  
                <asp:Parameter  
                    ConvertEmptyStringToNull="True|False"  
                    DefaultValue="string"  
                    Direction="Input|Output|InputOutput|ReturnValue"  
                    Name="string"  
                    Size="integer"  
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|  
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|  
                        Single|Double|Decimal|DateTime|String"  
                />  
                <asp:ProfileParameter  
                    ConvertEmptyStringToNull="True|False"  
                    DefaultValue="string"  
                    Direction="Input|Output|InputOutput|ReturnValue"  
                    Name="string"  
                    PropertyName="string"  
                    Size="integer"  
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|  
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|  
                        Single|Double|Decimal|DateTime|String"  
                />  
                <asp:QueryStringParameter  
                    ConvertEmptyStringToNull="True|False"  
                    DefaultValue="string"  
                    Direction="Input|Output|InputOutput|ReturnValue"  
                    Name="string"  
                    QueryStringField="string"  
                    Size="integer"  
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|  
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|  
                        Single|Double|Decimal|DateTime|String"  
                />  
                <asp:SessionParameter  
                    ConvertEmptyStringToNull="True|False"  
                    DefaultValue="string"  
                    Direction="Input|Output|InputOutput|ReturnValue"  
                    Name="string"  
                    SessionField="string"  
                    Size="integer"  
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|  
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|  
                        Single|Double|Decimal|DateTime|String"  
                />  
        </UpdateParameters>  
</asp:SqlDataSource>  

Costruttori

SqlDataSource() SqlDataSource() SqlDataSource() SqlDataSource()

Inizializza una nuova istanza della classe SqlDataSource.Initializes a new instance of the SqlDataSource class.

SqlDataSource(String, String) SqlDataSource(String, String) SqlDataSource(String, String) SqlDataSource(String, String)

Inizializza una nuova istanza della classe SqlDataSource con la stringa di connessione specificata e il comando Seleziona.Initializes a new instance of the SqlDataSource class with the specified connection string and Select command.

SqlDataSource(String, String, String) SqlDataSource(String, String, String) SqlDataSource(String, String, String) SqlDataSource(String, String, String)

Inizializza una nuova istanza della classe SqlDataSource con la stringa di connessione specificata e il comando Seleziona.Initializes a new instance of the SqlDataSource class with the specified connection string and Select command.

Proprietà

Adapter Adapter Adapter Adapter

Ottiene l'adattatore specifico del browser per il controllo.Gets the browser-specific adapter for the control.

(Inherited from Control)
AppRelativeTemplateSourceDirectory AppRelativeTemplateSourceDirectory AppRelativeTemplateSourceDirectory AppRelativeTemplateSourceDirectory

Ottiene o imposta la directory virtuale relativa all'applicazione dell'oggetto Page o UserControl contenente questo controllo.Gets or sets the application-relative virtual directory of the Page or UserControl object that contains this control.

(Inherited from Control)
BindingContainer BindingContainer BindingContainer BindingContainer

Ottiene il controllo contenente l'associazione dati del controllo corrente.Gets the control that contains this control's data binding.

(Inherited from Control)
CacheDuration CacheDuration CacheDuration CacheDuration

Ottiene o imposta il numero di secondi durante i quali il controllo origine dati memorizza nella cache i dati recuperati dal metodo Select(DataSourceSelectArguments).Gets or sets the length of time, in seconds, that the data source control caches data that is retrieved by the Select(DataSourceSelectArguments) method.

CacheExpirationPolicy CacheExpirationPolicy CacheExpirationPolicy CacheExpirationPolicy

Ottiene o imposta il comportamento di scadenza della cache che, quando combinato con la durata, descrive il comportamento della cache utilizzato dal controllo origine dati.Gets or sets the cache expiration behavior that, when combined with the duration, describes the behavior of the cache that the data source control uses.

CacheKeyDependency CacheKeyDependency CacheKeyDependency CacheKeyDependency

Ottiene o imposta una dipendenza di chiave definita dall'utente collegata a tutti gli oggetti cache dati creati dal controllo origine dati.Gets or sets a user-defined key dependency that is linked to all data cache objects that are created by the data source control. Tutti gli oggetti relativi alla cache scadono in modo esplicito quando scade la chiave.All cache objects are explicitly expired when the key is expired.

CancelSelectOnNullParameter CancelSelectOnNullParameter CancelSelectOnNullParameter CancelSelectOnNullParameter

Ottiene o imposta un valore indicante se un'operazione di recupero dati viene annullata quando qualsiasi parametro contenuto nell'insieme SelectParameters restituisce null.Gets or sets a value indicating whether a data retrieval operation is canceled when any parameter that is contained in the SelectParameters collection evaluates to null.

ChildControlsCreated ChildControlsCreated ChildControlsCreated ChildControlsCreated

Ottiene un valore che indica se i controlli figli del controllo server sono stati creati.Gets a value that indicates whether the server control's child controls have been created.

(Inherited from Control)
ClientID ClientID ClientID ClientID

Ottiene l'identificatore del controllo server generato da ASP.NET.Gets the server control identifier generated by ASP.NET.

(Inherited from DataSourceControl)
ClientIDMode ClientIDMode ClientIDMode ClientIDMode

Questa proprietà non viene utilizzata per i controlli origine dati.This property is not used for data source controls.

(Inherited from DataSourceControl)
ClientIDSeparator ClientIDSeparator ClientIDSeparator ClientIDSeparator

Ottiene un carattere che rappresenta il separatore utilizzato nella proprietà ClientID.Gets a character value representing the separator character used in the ClientID property.

(Inherited from Control)
ConflictDetection ConflictDetection ConflictDetection ConflictDetection

Ottiene o imposta il valore indicante come il controllo SqlDataSource esegue aggiornamenti ed eliminazioni quando i dati in una riga del database sottostante vengono modificati durante l'operazione.Gets or sets the value indicating how the SqlDataSource control performs updates and deletes when data in a row in the underlying database changes during the time of the operation.

ConnectionString ConnectionString ConnectionString ConnectionString

Ottiene o imposta la stringa di connessione specifica del provider ADO.NET usata dal controllo SqlDataSource per la connessione a un database sottostante.Gets or sets the ADO.NET provider-specific connection string that the SqlDataSource control uses to connect to an underlying database.

Context Context Context Context

Ottiene l'oggetto HttpContext associato al controllo server per la richiesta Web corrente.Gets the HttpContext object associated with the server control for the current Web request.

(Inherited from Control)
Controls Controls Controls Controls

Ottiene un oggetto ControlCollection che rappresenta i controlli figlio per un controllo server specificato nella gerarchia dell'interfaccia utente.Gets a ControlCollection object that represents the child controls for a specified server control in the UI hierarchy.

(Inherited from DataSourceControl)
DataItemContainer DataItemContainer DataItemContainer DataItemContainer

Ottiene un riferimento al contenitore di denominazione se il contenitore di denominazione implementa IDataItemContainer.Gets a reference to the naming container if the naming container implements IDataItemContainer.

(Inherited from Control)
DataKeysContainer DataKeysContainer DataKeysContainer DataKeysContainer

Ottiene un riferimento al contenitore di denominazione se il contenitore di denominazione implementa IDataKeysControl.Gets a reference to the naming container if the naming container implements IDataKeysControl.

(Inherited from Control)
DataSourceMode DataSourceMode DataSourceMode DataSourceMode

Ottiene o imposta la modalità di recupero dati utilizzata dal controllo SqlDataSource per recuperare dati.Gets or sets the data retrieval mode that the SqlDataSource control uses to fetch data.

DeleteCommand DeleteCommand DeleteCommand DeleteCommand

Ottiene o imposta la stringa SQL utilizzata dal controllo SqlDataSource per eliminare dati dal database sottostante.Gets or sets the SQL string that the SqlDataSource control uses to delete data from the underlying database.

DeleteCommandType DeleteCommandType DeleteCommandType DeleteCommandType

Ottiene o imposta un valore indicante se il testo nella proprietà DeleteCommand è un'istruzione SQL o il nome di una stored procedure.Gets or sets a value indicating whether the text in the DeleteCommand property is an SQL statement or the name of a stored procedure.

DeleteParameters DeleteParameters DeleteParameters DeleteParameters

Ottiene l'insieme di parametri che contiene i parametri utilizzati dalla proprietà DeleteCommand dall'oggetto SqlDataSourceView associato al controllo SqlDataSource.Gets the parameters collection that contains the parameters that are used by the DeleteCommand property from the SqlDataSourceView object that is associated with the SqlDataSource control.

DesignMode DesignMode DesignMode DesignMode

Ottiene un valore che indica se un controllo viene utilizzato in un'area di progettazione.Gets a value indicating whether a control is being used on a design surface.

(Inherited from Control)
EnableCaching EnableCaching EnableCaching EnableCaching

Ottiene o imposta un valore indicante se la memorizzazione di dati nella cache è abilitata nel controllo SqlDataSource.Gets or sets a value indicating whether the SqlDataSource control has data caching enabled.

EnableTheming EnableTheming EnableTheming EnableTheming

Ottiene un valore che indica se il controllo supporta i temi.Gets a value indicating whether this control supports themes.

(Inherited from DataSourceControl)
EnableViewState EnableViewState EnableViewState EnableViewState

Ottiene o imposta un valore che indica se lo stato di visualizzazione del controllo server deve essere persistente e lo stato di visualizzazione dei controlli figlio contenuti, per il client richiedente.Gets or sets a value indicating whether the server control persists its view state, and the view state of any child controls it contains, to the requesting client.

(Inherited from Control)
Events Events Events Events

Ottiene un elenco dei delegati del gestore eventi per il controllo.Gets a list of event handler delegates for the control. Questa proprietà è di sola lettura.This property is read-only.

(Inherited from Control)
FilterExpression FilterExpression FilterExpression FilterExpression

Ottiene o imposta un'espressione di filtro che viene applicata quando il metodo Select(DataSourceSelectArguments) viene chiamato.Gets or sets a filtering expression that is applied when the Select(DataSourceSelectArguments) method is called.

FilterParameters FilterParameters FilterParameters FilterParameters

Ottiene un insieme di parametri associati a tutti i segnaposto di parametro nella stringa FilterExpression.Gets a collection of parameters that are associated with any parameter placeholders that are in the FilterExpression string.

HasChildViewState HasChildViewState HasChildViewState HasChildViewState

Ottiene un valore che indica se per i controlli figlio del controllo server corrente esistono impostazioni dello stato di visualizzazione salvate.Gets a value indicating whether the current server control's child controls have any saved view-state settings.

(Inherited from Control)
IControlBuilderAccessor.ControlBuilder IControlBuilderAccessor.ControlBuilder IControlBuilderAccessor.ControlBuilder IControlBuilderAccessor.ControlBuilder

Per una descrizione di questo membro, vedere ControlBuilder.For a description of this member, see ControlBuilder.

(Inherited from Control)
IControlDesignerAccessor.UserData IControlDesignerAccessor.UserData IControlDesignerAccessor.UserData IControlDesignerAccessor.UserData

Per una descrizione di questo membro, vedere UserData.For a description of this member, see UserData.

(Inherited from Control)
ID ID ID ID

Ottiene o imposta l'identificatore a livello di codice assegnato al controllo server.Gets or sets the programmatic identifier assigned to the server control.

(Inherited from Control)
IDataBindingsAccessor.DataBindings IDataBindingsAccessor.DataBindings IDataBindingsAccessor.DataBindings IDataBindingsAccessor.DataBindings

Per una descrizione di questo membro, vedere DataBindings.For a description of this member, see DataBindings.

(Inherited from Control)
IDataBindingsAccessor.HasDataBindings IDataBindingsAccessor.HasDataBindings IDataBindingsAccessor.HasDataBindings IDataBindingsAccessor.HasDataBindings

Per una descrizione di questo membro, vedere HasDataBindings.For a description of this member, see HasDataBindings.

(Inherited from Control)
IdSeparator IdSeparator IdSeparator IdSeparator

Ottiene il carattere utilizzato per separare gli identificatori di controllo.Gets the character used to separate control identifiers.

(Inherited from Control)
IExpressionsAccessor.Expressions IExpressionsAccessor.Expressions IExpressionsAccessor.Expressions IExpressionsAccessor.Expressions

Per una descrizione di questo membro, vedere Expressions.For a description of this member, see Expressions.

(Inherited from Control)
IExpressionsAccessor.HasExpressions IExpressionsAccessor.HasExpressions IExpressionsAccessor.HasExpressions IExpressionsAccessor.HasExpressions

Per una descrizione di questo membro, vedere HasExpressions.For a description of this member, see HasExpressions.

(Inherited from Control)
IListSource.ContainsListCollection IListSource.ContainsListCollection IListSource.ContainsListCollection IListSource.ContainsListCollection

Indica se il controllo origine dati è associato a uno o più elenchi di dati.Indicates whether the data source control is associated with one or more lists of data.

(Inherited from DataSourceControl)
InsertCommand InsertCommand InsertCommand InsertCommand

Ottiene o imposta la stringa SQL utilizzata dal controllo SqlDataSource per inserire dati nel database sottostante.Gets or sets the SQL string that the SqlDataSource control uses to insert data into the underlying database.

InsertCommandType InsertCommandType InsertCommandType InsertCommandType

Ottiene o imposta un valore indicante se il testo nella proprietà InsertCommand è un'istruzione SQL o il nome di una stored procedure.Gets or sets a value indicating whether the text in the InsertCommand property is an SQL statement or the name of a stored procedure.

InsertParameters InsertParameters InsertParameters InsertParameters

Ottiene l'insieme di parametri che contiene i parametri utilizzati dalla proprietà InsertCommand dall'oggetto SqlDataSourceView associato al controllo SqlDataSource.Gets the parameters collection that contains the parameters that are used by the InsertCommand property from the SqlDataSourceView object that is associated with the SqlDataSource control.

IsChildControlStateCleared IsChildControlStateCleared IsChildControlStateCleared IsChildControlStateCleared

Ottiene un valore che indica se i controlli contenuti in questo controllo dispongono di informazioni sullo stato del controllo.Gets a value indicating whether controls contained within this control have control state.

(Inherited from Control)
IsTrackingViewState IsTrackingViewState IsTrackingViewState IsTrackingViewState

Ottiene un valore che indica se il controllo server salva le modifiche allo stato di visualizzazione.Gets a value that indicates whether the server control is saving changes to its view state.

(Inherited from Control)
IsViewStateEnabled IsViewStateEnabled IsViewStateEnabled IsViewStateEnabled

Ottiene un valore che indica se lo stato di visualizzazione è attivato per il controllo corrente.Gets a value indicating whether view state is enabled for this control.

(Inherited from Control)
LoadViewStateByID LoadViewStateByID LoadViewStateByID LoadViewStateByID

Ottiene un valore che indica se il controllo prende parte al caricamento del proprio stato di visualizzazione tramite ID anziché tramite l'indice.Gets a value indicating whether the control participates in loading its view state by ID instead of index.

(Inherited from Control)
NamingContainer NamingContainer NamingContainer NamingContainer

Ottiene un riferimento al contenitore dei nomi del controllo server, che crea uno spazio dei nomi univoco per distinguere i controlli server che hanno lo stesso valore della proprietà ID.Gets a reference to the server control's naming container, which creates a unique namespace for differentiating between server controls with the same ID property value.

(Inherited from Control)
OldValuesParameterFormatString OldValuesParameterFormatString OldValuesParameterFormatString OldValuesParameterFormatString

Ottiene o imposta una stringa di formato da applicare ai nomi di tutti i parametri passati al metodo Delete() o Update().Gets or sets a format string to apply to the names of any parameters that are passed to the Delete() or Update() method.

Page Page Page Page

Ottiene un riferimento all'istanza Page che contiene il controllo server.Gets a reference to the Page instance that contains the server control.

(Inherited from Control)
Parent Parent Parent Parent

Ottiene un riferimento al controllo padre del controllo server nella gerarchia dei controlli della pagina.Gets a reference to the server control's parent control in the page control hierarchy.

(Inherited from Control)
ProviderName ProviderName ProviderName ProviderName

Ottiene o imposta il nome del provider di dati .NET Framework utilizzato dal controllo SqlDataSource per la connessione a un'origine dati sottostante.Gets or sets the name of the .NET Framework data provider that the SqlDataSource control uses to connect to an underlying data source.

RenderingCompatibility RenderingCompatibility RenderingCompatibility RenderingCompatibility

Ottiene un valore che specifica la versione di ASP.NET con cui sarà compatibile il codice HTML di cui è stato eseguito il rendering.Gets a value that specifies the ASP.NET version that rendered HTML will be compatible with.

(Inherited from Control)
SelectCommand SelectCommand SelectCommand SelectCommand

Ottiene o imposta la stringa SQL utilizzata dal controllo SqlDataSource per recuperare dati dal database sottostante.Gets or sets the SQL string that the SqlDataSource control uses to retrieve data from the underlying database.

SelectCommandType SelectCommandType SelectCommandType SelectCommandType

Ottiene o imposta un valore indicante se il testo nella proprietà SelectCommand è una query SQL o il nome di una stored procedure.Gets or sets a value indicating whether the text in the SelectCommand property is an SQL query or the name of a stored procedure.

SelectParameters SelectParameters SelectParameters SelectParameters

Ottiene l'insieme di parametri che contiene i parametri utilizzati dalla proprietà SelectCommand dall'oggetto SqlDataSourceView associato al controllo SqlDataSource.Gets the parameters collection that contains the parameters that are used by the SelectCommand property from the SqlDataSourceView object that is associated with the SqlDataSource control.

Site Site Site Site

Ottiene informazioni sul contenitore del controllo corrente quando viene eseguito il rendering in un'area di progettazione.Gets information about the container that hosts the current control when rendered on a design surface.

(Inherited from Control)
SkinID SkinID SkinID SkinID

Ottiene l'interfaccia da applicare al controllo DataSourceControl.Gets the skin to apply to the DataSourceControl control.

(Inherited from DataSourceControl)
SortParameterName SortParameterName SortParameterName SortParameterName

Ottiene o imposta il nome di un parametro di stored procedure utilizzato per ordinare i dati recuperati quando il recupero dati viene eseguito utilizzando una stored procedure.Gets or sets the name of a stored procedure parameter that is used to sort retrieved data when data retrieval is performed using a stored procedure.

SqlCacheDependency SqlCacheDependency SqlCacheDependency SqlCacheDependency

Ottiene o imposta una stringa delimitata da punti e virgola che indica i database e le tabelle da utilizzare per la dipendenza della cache da Microsoft SQL Server.Gets or sets a semicolon-delimited string that indicates which databases and tables to use for the Microsoft SQL Server cache dependency.

TemplateControl TemplateControl TemplateControl TemplateControl

Ottiene o imposta un riferimento al modello che contiene il controllo.Gets or sets a reference to the template that contains this control.

(Inherited from Control)
TemplateSourceDirectory TemplateSourceDirectory TemplateSourceDirectory TemplateSourceDirectory

Ottiene la directory virtuale dell'oggetto Page o dell'oggetto UserControl che contiene il controllo server corrente.Gets the virtual directory of the Page or UserControl that contains the current server control.

(Inherited from Control)
UniqueID UniqueID UniqueID UniqueID

Ottiene l'identificatore univoco qualificato gerarchicamente per il controllo server.Gets the unique, hierarchically qualified identifier for the server control.

(Inherited from Control)
UpdateCommand UpdateCommand UpdateCommand UpdateCommand

Ottiene o imposta la stringa SQL utilizzata dal controllo SqlDataSource per aggiornare i dati nel database sottostante.Gets or sets the SQL string that the SqlDataSource control uses to update data in the underlying database.

UpdateCommandType UpdateCommandType UpdateCommandType UpdateCommandType

Ottiene o imposta un valore indicante se il testo nella proprietà UpdateCommand è un'istruzione SQL o il nome di una stored procedure.Gets or sets a value indicating whether the text in the UpdateCommand property is an SQL statement or the name of a stored procedure.

UpdateParameters UpdateParameters UpdateParameters UpdateParameters

Ottiene l'insieme di parametri che contiene i parametri utilizzati dalla proprietà UpdateCommand dal controllo SqlDataSourceView associato al controllo SqlDataSource.Gets the parameters collection that contains the parameters that are used by the UpdateCommand property from the SqlDataSourceView control that is associated with the SqlDataSource control.

ValidateRequestMode ValidateRequestMode ValidateRequestMode ValidateRequestMode

Ottiene o imposta un valore che indica se il controllo verifica la presenza di valori potenzialmente pericolosi nell'input proveniente dal browser.Gets or sets a value that indicates whether the control checks client input from the browser for potentially dangerous values.

(Inherited from Control)
ViewState ViewState ViewState ViewState

Ottiene un dizionario di informazioni sullo stato che permette di salvare e ripristinare lo stato di visualizzazione di un controllo server attraverso più richieste per la stessa pagina.Gets a dictionary of state information that allows you to save and restore the view state of a server control across multiple requests for the same page.

(Inherited from Control)
ViewStateIgnoresCase ViewStateIgnoresCase ViewStateIgnoresCase ViewStateIgnoresCase

Ottiene un valore che indica se l'oggetto StateBag non effettua la distinzione tra maiuscole e minuscole.Gets a value that indicates whether the StateBag object is case-insensitive.

(Inherited from Control)
ViewStateMode ViewStateMode ViewStateMode ViewStateMode

Ottiene o imposta la modalità dello stato, visualizzazione di questo controllo.Gets or sets the view-state mode of this control.

(Inherited from Control)
Visible Visible Visible Visible

Ottiene o imposta un valore che indica se il controllo è visualizzato.Gets or sets a value indicating whether the control is visually displayed.

(Inherited from DataSourceControl)

Metodi

AddedControl(Control, Int32) AddedControl(Control, Int32) AddedControl(Control, Int32) AddedControl(Control, Int32)

Chiamato dopo che un controllo figlio viene aggiunto alla raccolta Controls dell'oggetto Control.Called after a child control is added to the Controls collection of the Control object.

(Inherited from Control)
AddParsedSubObject(Object) AddParsedSubObject(Object) AddParsedSubObject(Object) AddParsedSubObject(Object)

Notifica al controllo server che un elemento, XML o HTML, è stato analizzato e aggiunge l'elemento all'oggetto ControlCollection del controllo server.Notifies the server control that an element, either XML or HTML, was parsed, and adds the element to the server control's ControlCollection object.

(Inherited from Control)
ApplyStyleSheetSkin(Page) ApplyStyleSheetSkin(Page) ApplyStyleSheetSkin(Page) ApplyStyleSheetSkin(Page)

Applica al controllo le proprietà di stile definite nel foglio di stile della pagina.Applies the style properties that are defined in the page style sheet to the control.

(Inherited from DataSourceControl)
BeginRenderTracing(TextWriter, Object) BeginRenderTracing(TextWriter, Object) BeginRenderTracing(TextWriter, Object) BeginRenderTracing(TextWriter, Object)

Inizia la traccia in fase di progettazione dei dati di rendering.Begins design-time tracing of rendering data.

(Inherited from Control)
BuildProfileTree(String, Boolean) BuildProfileTree(String, Boolean) BuildProfileTree(String, Boolean) BuildProfileTree(String, Boolean)

Raccoglie informazioni sul controllo server e le recapita alla proprietà Trace in modo che vengano visualizzate quando è attivata la tracciatura per la pagina.Gathers information about the server control and delivers it to the Trace property to be displayed when tracing is enabled for the page.

(Inherited from Control)
ClearCachedClientID() ClearCachedClientID() ClearCachedClientID() ClearCachedClientID()

Imposta il valore memorizzato nella cache ClientID su null.Sets the cached ClientID value to null.

(Inherited from Control)
ClearChildControlState() ClearChildControlState() ClearChildControlState() ClearChildControlState()

Elimina le informazioni sullo stato del controllo per i controlli figlio del controllo server.Deletes the control-state information for the server control's child controls.

(Inherited from Control)
ClearChildState() ClearChildState() ClearChildState() ClearChildState()

Elimina le informazioni sullo stato di visualizzazione e sullo stato del controllo per tutti i controlli figlio del controllo server.Deletes the view-state and control-state information for all the server control's child controls.

(Inherited from Control)
ClearChildViewState() ClearChildViewState() ClearChildViewState() ClearChildViewState()

Elimina le informazioni sullo stato di visualizzazione per tutti i controlli figlio del controllo server.Deletes the view-state information for all the server control's child controls.

(Inherited from Control)
ClearEffectiveClientIDMode() ClearEffectiveClientIDMode() ClearEffectiveClientIDMode() ClearEffectiveClientIDMode()

Imposta la proprietà ClientIDMode dell'istanza del controllo corrente e di tutti i controlli figlio su Inherit.Sets the ClientIDMode property of the current control instance and of any child controls to Inherit.

(Inherited from Control)
CreateChildControls() CreateChildControls() CreateChildControls() CreateChildControls()

Viene chiamato dal framework della pagina ASP.NET per notificare ai controlli server che usano un'implementazione basata sulla composizione di creare gli eventuali controlli figlio in essi contenuti in preparazione per il postback o il rendering.Called by the ASP.NET page framework to notify server controls that use composition-based implementation to create any child controls they contain in preparation for posting back or rendering.

(Inherited from Control)
CreateControlCollection() CreateControlCollection() CreateControlCollection() CreateControlCollection()

Crea una raccolta per l'archiviazione di controlli figlio.Creates a collection to store child controls.

(Inherited from DataSourceControl)
CreateDataSourceView(String) CreateDataSourceView(String) CreateDataSourceView(String) CreateDataSourceView(String)

Crea un oggetto visualizzazione origine dati associato al controllo origine dati.Creates a data source view object that is associated with the data source control.

DataBind() DataBind() DataBind() DataBind()

Associa un'origine dati al controllo server richiamato e a tutti i relativi controlli figlio.Binds a data source to the invoked server control and all its child controls.

(Inherited from Control)
DataBind(Boolean) DataBind(Boolean) DataBind(Boolean) DataBind(Boolean)

Associa un'origine dati al controllo server chiamato e ai relativi controlli figlio con un'opzione per generare l'evento DataBinding.Binds a data source to the invoked server control and all its child controls with an option to raise the DataBinding event.

(Inherited from Control)
DataBindChildren() DataBindChildren() DataBindChildren() DataBindChildren()

Associa un'origine dati al controllo server e ai relativi controlli figlio.Binds a data source to the server control's child controls.

(Inherited from Control)
Delete() Delete() Delete() Delete()

Esegue un'operazione di eliminazione utilizzando la stringa SQL DeleteCommand e tutti i parametri nell'insieme DeleteParameters.Performs a delete operation using the DeleteCommand SQL string and any parameters that are in the DeleteParameters collection.

Dispose() Dispose() Dispose() Dispose()

Abilita un controllo server alla pulizia finale prima che venga rilasciato dalla memoria.Enables a server control to perform final clean up before it is released from memory.

(Inherited from Control)
EndRenderTracing(TextWriter, Object) EndRenderTracing(TextWriter, Object) EndRenderTracing(TextWriter, Object) EndRenderTracing(TextWriter, Object)

Termina la traccia in fase di progettazione dei dati di rendering.Ends design-time tracing of rendering data.

(Inherited from Control)
EnsureChildControls() EnsureChildControls() EnsureChildControls() EnsureChildControls()

Determina se il controllo server contiene controlli figlio.Determines whether the server control contains child controls. In caso contrario, li crea.If it does not, it creates child controls.

(Inherited from Control)
EnsureID() EnsureID() EnsureID() EnsureID()

Crea un identificatore per i controlli a cui non è assegnato alcun identificatore.Creates an identifier for controls that do not have an identifier assigned.

(Inherited from Control)
Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.Determines whether the specified object is equal to the current object.

(Inherited from Object)
FindControl(String) FindControl(String) FindControl(String) FindControl(String)

Cerca un controllo server nel contenitore dei nomi corrente con il parametro id specificato.Searches the current naming container for a server control with the specified id parameter.

(Inherited from DataSourceControl)
FindControl(String, Int32) FindControl(String, Int32) FindControl(String, Int32) FindControl(String, Int32)

Cerca nel contenitore di denominazione corrente un controllo server con il parametro id indicato e un intero, specificato nel parametro pathOffset, che agevola la ricerca.Searches the current naming container for a server control with the specified id and an integer, specified in the pathOffset parameter, which aids in the search. Non eseguire l'override di questa versione del metodo FindControl.You should not override this version of the FindControl method.

(Inherited from Control)
Focus() Focus() Focus() Focus()

Imposta lo stato attivo per l'input del controllo.Sets input focus to the control.

(Inherited from DataSourceControl)
GetDbProviderFactory() GetDbProviderFactory() GetDbProviderFactory() GetDbProviderFactory()

Restituisce l'oggetto DbProviderFactory associato al provider ADO.NET identificato dalla proprietà ProviderName.Returns the DbProviderFactory object that is associated with the ADO.NET provider that is identified by the ProviderName property.

GetDesignModeState() GetDesignModeState() GetDesignModeState() GetDesignModeState()

Ottiene i dati della fase di progettazione per un controllo.Gets design-time data for a control.

(Inherited from Control)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Funge da funzione hash predefinita.Serves as the default hash function.

(Inherited from Object)
GetRouteUrl(Object) GetRouteUrl(Object) GetRouteUrl(Object) GetRouteUrl(Object)

Ottiene l'URL corrispondente a un set di parametri di route.Gets the URL that corresponds to a set of route parameters.

(Inherited from Control)
GetRouteUrl(RouteValueDictionary) GetRouteUrl(RouteValueDictionary) GetRouteUrl(RouteValueDictionary) GetRouteUrl(RouteValueDictionary)

Ottiene l'URL corrispondente a un set di parametri di route.Gets the URL that corresponds to a set of route parameters.

(Inherited from Control)
GetRouteUrl(String, Object) GetRouteUrl(String, Object) GetRouteUrl(String, Object) GetRouteUrl(String, Object)

Ottiene l'URL che corrisponde a un set di parametri di route e a un nome della route.Gets the URL that corresponds to a set of route parameters and a route name.

(Inherited from Control)
GetRouteUrl(String, RouteValueDictionary) GetRouteUrl(String, RouteValueDictionary) GetRouteUrl(String, RouteValueDictionary) GetRouteUrl(String, RouteValueDictionary)

Ottiene l'URL che corrisponde a un set di parametri di route e a un nome della route.Gets the URL that corresponds to a set of route parameters and a route name.

(Inherited from Control)
GetType() GetType() GetType() GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Inherited from Object)
GetUniqueIDRelativeTo(Control) GetUniqueIDRelativeTo(Control) GetUniqueIDRelativeTo(Control) GetUniqueIDRelativeTo(Control)

Restituisce la parte con prefisso della proprietà UniqueID del controllo specificato.Returns the prefixed portion of the UniqueID property of the specified control.

(Inherited from Control)
GetView(String) GetView(String) GetView(String) GetView(String)

Ottiene la visualizzazione origine dati denominata associata al controllo origine dati.Gets the named data source view that is associated with the data source control.

GetViewNames() GetViewNames() GetViewNames() GetViewNames()

Ottiene un insieme di nomi che rappresentano l'elenco di oggetti visualizzazione associati al controllo SqlDataSource.Gets a collection of names representing the list of view objects that are associated with the SqlDataSource control.

HasControls() HasControls() HasControls() HasControls()

Determina se il controllo server contiene controlli figlio.Determines if the server control contains any child controls.

(Inherited from DataSourceControl)
HasEvents() HasEvents() HasEvents() HasEvents()

Restituisce un valore che indica se gli eventi vengono registrati per il controllo o eventuali controlli figlio.Returns a value indicating whether events are registered for the control or any child controls.

(Inherited from Control)
Insert() Insert() Insert() Insert()

Esegue un'operazione di inserimento utilizzando la stringa SQL InsertCommand e tutti i parametri nell'insieme InsertParameters.Performs an insert operation using the InsertCommand SQL string and any parameters that are in the InsertParameters collection.

IsLiteralContent() IsLiteralContent() IsLiteralContent() IsLiteralContent()

Determina se il controllo server conserva solo il contenuto literal.Determines if the server control holds only literal content.

(Inherited from Control)
LoadControlState(Object) LoadControlState(Object) LoadControlState(Object) LoadControlState(Object)

Ripristina le informazioni sullo stato del controllo da una richiesta di pagina precedente salvata dal metodo SaveControlState().Restores control-state information from a previous page request that was saved by the SaveControlState() method.

(Inherited from Control)
LoadViewState(Object) LoadViewState(Object) LoadViewState(Object) LoadViewState(Object)

Carica nel controllo SqlDataSource lo stato delle proprietà che devono essere mantenute.Loads the state of the properties in the SqlDataSource control that need to be persisted.

MapPathSecure(String) MapPathSecure(String) MapPathSecure(String) MapPathSecure(String)

Recupera il percorso fisico al quale è associato un percorso virtuale, assoluto o relativo.Retrieves the physical path that a virtual path, either absolute or relative, maps to.

(Inherited from Control)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Inherited from Object)
OnBubbleEvent(Object, EventArgs) OnBubbleEvent(Object, EventArgs) OnBubbleEvent(Object, EventArgs) OnBubbleEvent(Object, EventArgs)

Determina se l'evento per il controllo server viene passato a un livello superiore nella gerarchia dei controlli server dell'interfaccia utente per la pagina.Determines whether the event for the server control is passed up the page's UI server control hierarchy.

(Inherited from Control)
OnDataBinding(EventArgs) OnDataBinding(EventArgs) OnDataBinding(EventArgs) OnDataBinding(EventArgs)

Genera l'evento DataBinding.Raises the DataBinding event.

(Inherited from Control)
OnInit(EventArgs) OnInit(EventArgs) OnInit(EventArgs) OnInit(EventArgs)

Aggiunge un gestore eventi LoadComplete al controllo Page che contiene il controllo SqlDataSource.Adds a LoadComplete event handler to the Page control that contains the SqlDataSource control.

OnLoad(EventArgs) OnLoad(EventArgs) OnLoad(EventArgs) OnLoad(EventArgs)

Genera l'evento Load.Raises the Load event.

(Inherited from Control)
OnPreRender(EventArgs) OnPreRender(EventArgs) OnPreRender(EventArgs) OnPreRender(EventArgs)

Genera l'evento PreRender.Raises the PreRender event.

(Inherited from Control)
OnUnload(EventArgs) OnUnload(EventArgs) OnUnload(EventArgs) OnUnload(EventArgs)

Genera l'evento Unload.Raises the Unload event.

(Inherited from Control)
OpenFile(String) OpenFile(String) OpenFile(String) OpenFile(String)

Ottiene un oggetto Stream utilizzato per leggere un file.Gets a Stream used to read a file.

(Inherited from Control)
RaiseBubbleEvent(Object, EventArgs) RaiseBubbleEvent(Object, EventArgs) RaiseBubbleEvent(Object, EventArgs) RaiseBubbleEvent(Object, EventArgs)

Assegna eventuali origini dell'evento e relative informazioni al controllo padre.Assigns any sources of the event and its information to the control's parent.

(Inherited from Control)
RaiseDataSourceChangedEvent(EventArgs) RaiseDataSourceChangedEvent(EventArgs) RaiseDataSourceChangedEvent(EventArgs) RaiseDataSourceChangedEvent(EventArgs)

Genera l'evento DataSourceChanged.Raises the DataSourceChanged event.

(Inherited from DataSourceControl)
RemovedControl(Control) RemovedControl(Control) RemovedControl(Control) RemovedControl(Control)

Chiamato dopo che un controllo figlio viene rimosso dalla raccolta Controls dell'oggetto Control.Called after a child control is removed from the Controls collection of the Control object.

(Inherited from Control)
Render(HtmlTextWriter) Render(HtmlTextWriter) Render(HtmlTextWriter) Render(HtmlTextWriter)

Invia il contenuto del controllo server a un oggetto HtmlTextWriter specificato che scrive il contenuto di cui eseguire il rendering nel client.Sends server control content to a provided HtmlTextWriter object, which writes the content to be rendered on the client.

(Inherited from Control)
RenderChildren(HtmlTextWriter) RenderChildren(HtmlTextWriter) RenderChildren(HtmlTextWriter) RenderChildren(HtmlTextWriter)

Invia il contenuto di un controllo figlio del controllo server a un oggetto HtmlTextWriter fornito, che scrive il contenuto di cui verrà effettuato il rendering sul client.Outputs the content of a server control's children to a provided HtmlTextWriter object, which writes the content to be rendered on the client.

(Inherited from Control)
RenderControl(HtmlTextWriter) RenderControl(HtmlTextWriter) RenderControl(HtmlTextWriter) RenderControl(HtmlTextWriter)

Restituisce il contenuto del controllo server a un oggetto HtmlTextWriter specificato e archivia le informazioni di traccia relative al controllo se la funzionalità di traccia è abilitata.Outputs server control content to a provided HtmlTextWriter object and stores tracing information about the control if tracing is enabled.

(Inherited from DataSourceControl)
RenderControl(HtmlTextWriter, ControlAdapter) RenderControl(HtmlTextWriter, ControlAdapter) RenderControl(HtmlTextWriter, ControlAdapter) RenderControl(HtmlTextWriter, ControlAdapter)

Restituisce il contenuto del controllo server a un oggetto HtmlTextWriter specificato utilizzando un oggetto ControlAdapter specificato.Outputs server control content to a provided HtmlTextWriter object using a provided ControlAdapter object.

(Inherited from Control)
ResolveAdapter() ResolveAdapter() ResolveAdapter() ResolveAdapter()

Ottiene l'adattatore del controllo responsabile del rendering del controllo specificato.Gets the control adapter responsible for rendering the specified control.

(Inherited from Control)
ResolveClientUrl(String) ResolveClientUrl(String) ResolveClientUrl(String) ResolveClientUrl(String)

Ottiene un URL che può essere utilizzato dal browser.Gets a URL that can be used by the browser.

(Inherited from Control)
ResolveUrl(String) ResolveUrl(String) ResolveUrl(String) ResolveUrl(String)

Converte un URL in un formato utilizzabile dal client richiedente.Converts a URL into one that is usable on the requesting client.

(Inherited from Control)
SaveControlState() SaveControlState() SaveControlState() SaveControlState()

Salva tutte le modifiche dello stato di un controllo server apportate dopo il postback della pagina nel server.Saves any server control state changes that have occurred since the time the page was posted back to the server.

(Inherited from Control)
SaveViewState() SaveViewState() SaveViewState() SaveViewState()

Salva lo stato di visualizzazione corrente del controllo SqlDataSource.Saves the current view state of the SqlDataSource control.

Select(DataSourceSelectArguments) Select(DataSourceSelectArguments) Select(DataSourceSelectArguments) Select(DataSourceSelectArguments)

Recupera dati dal database sottostante utilizzando la stringa SQL SelectCommand e tutti i parametri dell'insieme SelectParameters.Retrieves data from the underlying database by using the SelectCommand SQL string and any parameters that are in the SelectParameters collection.

SetDesignModeState(IDictionary) SetDesignModeState(IDictionary) SetDesignModeState(IDictionary) SetDesignModeState(IDictionary)

Imposta i dati della fase di progettazione per un controllo.Sets design-time data for a control.

(Inherited from Control)
SetRenderMethodDelegate(RenderMethod) SetRenderMethodDelegate(RenderMethod) SetRenderMethodDelegate(RenderMethod) SetRenderMethodDelegate(RenderMethod)

Assegna un delegato del gestore eventi per eseguire il rendering del controllo server e del relativo contenuto nel controllo padre.Assigns an event handler delegate to render the server control and its content into its parent control.

(Inherited from Control)
SetTraceData(Object, Object) SetTraceData(Object, Object) SetTraceData(Object, Object) SetTraceData(Object, Object)

Imposta i dati di traccia per la traccia durante la fase di progettazione dei dati di rendering, utilizzando la chiave dei dati di traccia e il valore dei dati di traccia.Sets trace data for design-time tracing of rendering data, using the trace data key and the trace data value.

(Inherited from Control)
SetTraceData(Object, Object, Object) SetTraceData(Object, Object, Object) SetTraceData(Object, Object, Object) SetTraceData(Object, Object, Object)

Imposta i dati di traccia per la traccia durante la fase di progettazione dei dati di rendering, utilizzando l'oggetto tracciato, la chiave dei dati di traccia e il valore dei dati di traccia.Sets trace data for design-time tracing of rendering data, using the traced object, the trace data key, and the trace data value.

(Inherited from Control)
ToString() ToString() ToString() ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.Returns a string that represents the current object.

(Inherited from Object)
TrackViewState() TrackViewState() TrackViewState() TrackViewState()

Tiene traccia delle modifiche dello stato di visualizzazione del controllo SqlDataSource in modo che possano essere archiviate nell'oggetto StateBag per il controllo.Tracks view state changes to the SqlDataSource control so that the changes can be stored in the StateBag object for the control.

Update() Update() Update() Update()

Esegue un'operazione di aggiornamento utilizzando la stringa SQL UpdateCommand e tutti i parametri nell'insieme UpdateParameters.Performs an update operation using the UpdateCommand SQL string and any parameters that are in the UpdateParameters collection.

Eventi

DataBinding DataBinding DataBinding DataBinding

Viene generato quando il controllo server viene associato a un'origine dati.Occurs when the server control binds to a data source.

(Inherited from Control)
Deleted Deleted Deleted Deleted

Si verifica quando viene completata un'operazione di eliminazione.Occurs when a delete operation has completed.

Deleting Deleting Deleting Deleting

Si verifica prima di un'operazione di eliminazione.Occurs before a delete operation.

Disposed Disposed Disposed Disposed

Si verifica quando un controllo server viene rilasciato dalla memoria, ossia nell'ultima fase della durata di un controllo server quando viene richiesta una pagina ASP.NET.Occurs when a server control is released from memory, which is the last stage of the server control lifecycle when an ASP.NET page is requested.

(Inherited from Control)
Filtering Filtering Filtering Filtering

Si verifica prima di un'operazione di filtro.Occurs before a filter operation.

IDataSource.DataSourceChanged IDataSource.DataSourceChanged IDataSource.DataSourceChanged IDataSource.DataSourceChanged

Si verifica quando a un controllo origine dati sono state apportate modifiche che influiscono sui controlli con associazione a dati.Occurs when a data source control has changed in a way that affects data-bound controls.

(Inherited from DataSourceControl)
Init Init Init Init

Viene generato quando il controllo server viene inizializzato, ovvero nella prima fase della sua durata.Occurs when the server control is initialized, which is the first step in its lifecycle.

(Inherited from Control)
Inserted Inserted Inserted Inserted

Si verifica quando viene completata un'operazione di inserimento.Occurs when an insert operation has completed.

Inserting Inserting Inserting Inserting

Si verifica prima di un'operazione di inserimento.Occurs before an insert operation.

Load Load Load Load

Viene generato quando il controllo server è caricato nell'oggetto Page.Occurs when the server control is loaded into the Page object.

(Inherited from Control)
PreRender PreRender PreRender PreRender

Si verifica dopo il caricamento dell'oggetto Control ma prima del rendering.Occurs after the Control object is loaded but prior to rendering.

(Inherited from Control)
Selected Selected Selected Selected

Si verifica quando viene completata un'operazione di recupero.Occurs when a data retrieval operation has completed.

Selecting Selecting Selecting Selecting

Si verifica prima di un'operazione di recupero dati.Occurs before a data retrieval operation.

Unload Unload Unload Unload

Viene generato quando il controllo server viene scaricato dalla memoria.Occurs when the server control is unloaded from memory.

(Inherited from Control)
Updated Updated Updated Updated

Si verifica quando viene completata un'operazione di aggiornamento.Occurs when an update operation has completed.

Updating Updating Updating Updating

Si verifica prima di un'operazione di aggiornamento.Occurs before an update operation.

Implementazioni dell'interfaccia esplicita

IControlDesignerAccessor.GetDesignModeState() IControlDesignerAccessor.GetDesignModeState() IControlDesignerAccessor.GetDesignModeState() IControlDesignerAccessor.GetDesignModeState()

Per una descrizione di questo membro, vedere GetDesignModeState().For a description of this member, see GetDesignModeState().

(Inherited from Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary) IControlDesignerAccessor.SetDesignModeState(IDictionary) IControlDesignerAccessor.SetDesignModeState(IDictionary) IControlDesignerAccessor.SetDesignModeState(IDictionary)

Per una descrizione di questo membro, vedere SetDesignModeState(IDictionary).For a description of this member, see SetDesignModeState(IDictionary).

(Inherited from Control)
IControlDesignerAccessor.SetOwnerControl(Control) IControlDesignerAccessor.SetOwnerControl(Control) IControlDesignerAccessor.SetOwnerControl(Control) IControlDesignerAccessor.SetOwnerControl(Control)

Per una descrizione di questo membro, vedere SetOwnerControl(Control).For a description of this member, see SetOwnerControl(Control).

(Inherited from Control)
IDataSource.GetView(String) IDataSource.GetView(String) IDataSource.GetView(String) IDataSource.GetView(String)

Ottiene l'oggetto DataSourceView denominato associato al controllo DataSourceControl.Gets the named DataSourceView object associated with the DataSourceControl control. Alcuni controlli origine dati supportano una sola visualizzazione, mentre altri ne supportano più di una.Some data source controls support only one view, while others support more than one.

(Inherited from DataSourceControl)
IDataSource.GetViewNames() IDataSource.GetViewNames() IDataSource.GetViewNames() IDataSource.GetViewNames()

Ottiene un insieme di nomi che rappresentano l'elenco di oggetti DataSourceView associati al controllo DataSourceControl.Gets a collection of names, representing the list of DataSourceView objects associated with the DataSourceControl control.

(Inherited from DataSourceControl)
IListSource.GetList() IListSource.GetList() IListSource.GetList() IListSource.GetList()

Ottiene un elenco di controlli origine dati che possono essere utilizzati come origini degli elenchi di dati.Gets a list of data source controls that can be used as sources of lists of data.

(Inherited from DataSourceControl)
IParserAccessor.AddParsedSubObject(Object) IParserAccessor.AddParsedSubObject(Object) IParserAccessor.AddParsedSubObject(Object) IParserAccessor.AddParsedSubObject(Object)

Per una descrizione di questo membro, vedere AddParsedSubObject(Object).For a description of this member, see AddParsedSubObject(Object).

(Inherited from Control)

Metodi di estensione

FindDataSourceControl(Control) FindDataSourceControl(Control) FindDataSourceControl(Control) FindDataSourceControl(Control)

Restituisce l'origine dati associata al controllo dati per il controllo specificato.Returns the data source that is associated with the data control for the specified control.

FindFieldTemplate(Control, String) FindFieldTemplate(Control, String) FindFieldTemplate(Control, String) FindFieldTemplate(Control, String)

Restituisce il modello di campo per la colonna specificata nel contenitore di denominazione del controllo specificato.Returns the field template for the specified column in the specified control's naming container.

FindMetaTable(Control) FindMetaTable(Control) FindMetaTable(Control) FindMetaTable(Control)

Restituisce l'oggetto metatabella per il controllo contenitore dei dati.Returns the metatable object for the containing data control.

GetDefaultValues(IDataSource) GetDefaultValues(IDataSource) GetDefaultValues(IDataSource) GetDefaultValues(IDataSource)

Ottiene l'insieme di valori predefiniti per l'origine dati specificata.Gets the collection of the default values for the specified data source.

GetMetaTable(IDataSource) GetMetaTable(IDataSource) GetMetaTable(IDataSource) GetMetaTable(IDataSource)

Ottiene i metadati per una tabella nell'oggetto origine dati specificato.Gets the metadata for a table in the specified data source object.

TryGetMetaTable(IDataSource, MetaTable) TryGetMetaTable(IDataSource, MetaTable) TryGetMetaTable(IDataSource, MetaTable) TryGetMetaTable(IDataSource, MetaTable)

Determina se sono disponibili i metadati della tabella.Determines whether table metadata is available.

Si applica a

Vedi anche