SqlDataSourceStatusEventArgs Classe

Riferimento

Definizione

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

Assembly:: System.Web.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Fornisce dati per un evento generato dal controllo SqlDataSource dopo che è stata completata un'operazione sui dati.

public ref class SqlDataSourceStatusEventArgs : EventArgs

public class SqlDataSourceStatusEventArgs : EventArgs

type SqlDataSourceStatusEventArgs = class
    inherit EventArgs

Public Class SqlDataSourceStatusEventArgs
Inherits EventArgs

Ereditarietà: Object

EventArgs
SqlDataSourceStatusEventArgs

Esempio

Nell'esempio di codice seguente viene illustrato come utilizzare la SqlDataSourceStatusEventArgs classe per esaminare il valore restituito e i valori dei parametri di output restituiti quando si usa un SqlDataSource controllo con una stored procedure per popolare un GridView controllo. La stored procedure seleziona i dati visualizzati in GridView, ma passa anche altre informazioni al chiamante, ad esempio un parametro di output integer e un valore restituito. I parametri utilizzati dall'oggetto SqlDataSource per la stored procedure sono contenuti nella SelectParameters raccolta e sono costituiti da parametri che passano informazioni dal Modulo Web alla stored procedure, nonché parametri che passano di nuovo le informazioni al modulo. La Direction proprietà di questi parametri è impostata su Output e ReturnValue.

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

<script runat="server">
// Clicking the Submit button explicitly refreshes the data 
// by calling the Select() method.
private void Submit(Object source, EventArgs e) {
  SqlDataSource1.Select(DataSourceSelectArguments.Empty);
}

// This event handler is called after the Select() method is executed.
private void OnSelectedHandler(Object source, SqlDataSourceStatusEventArgs e) {

  IDbCommand cmd = e.Command; 
  
  Label1.Text = "Parameter return values: ";

  foreach (SqlParameter param in cmd.Parameters) {
    //  Extract the value of the parameter.
    Label1.Text += param.ParameterName + " - " + param.Value.ToString();
  }
}
</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"
            datasourcemode="DataSet"
            connectionstring="<%$ ConnectionStrings:MyNorthwind%>"
            selectcommand="getordertotal"
            onselected="OnSelectedHandler">
            <selectparameters>
              <asp:querystringparameter name="empId" querystringfield="empId" />
              <asp:parameter name="total" type="Int32" direction="Output" defaultvalue="0" />
              <asp:parameter name="_ret" type="Int32" direction="ReturnValue" defaultvalue="0" />
            </selectparameters>
        </asp:sqldatasource>
        <!--
          CREATE PROCEDURE dbo.getordertotal
            @empId int,
            @total int OUTPUT
          as
            set nocount on
            select @total    = count(1) from orders where employeeid=@empid;
            select * from orders where employeeID = @empId ;
            return (-1000);
          GO
        -->

        <asp:gridview
          id="GridView1"
          runat="server"
          allowpaging="True"
          pagesize="5"
          datasourceid="SqlDataSource1" />

        <asp:button
          id="Button1"
          runat="server"
          onclick="Submit"
          text="Refresh Data" />

        <asp:label id="Label1" runat="server" />

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

<%@Page  Language="VB" %>
<%@Import Namespace="System.Data" %>
<%@Import Namespace="System.Data.Common" %>
<%@Import Namespace="System.Data.SqlClient" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">
' Clicking the Submit button explicitly refreshes the data 
' by calling the Select() method.
Private Sub Submit(source As Object, e As EventArgs)
  
  SqlDataSource1.Select(DataSourceSelectArguments.Empty)
  
End Sub ' Submit

' This event handler is called after the Select() method is executed.
Private Sub OnSelectedHandler(source As Object, e As SqlDataSourceStatusEventArgs)

  Dim cmd As IDbCommand 
  cmd = e.Command
  Dim param As SqlParameter
  
  Label1.Text = "Parameter return values: "
  
  For Each param In cmd.Parameters
    
    ' Extract the name and value of the parameter.
    Label1.Text = Label1.Text & param.ParameterName & " - " & _
                  param.Value.ToString()

  Next

End Sub ' OnSelectedHandler
</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"
            datasourcemode="DataSet"
            connectionstring="<%$ ConnectionStrings:MyNorthwind%>"
            selectcommand="getordertotal"
            onselected="OnSelectedHandler">
            <selectparameters>
              <asp:querystringparameter name="empId" querystringfield="empId" />
              <asp:parameter name="total" type="Int32" direction="Output" defaultvalue="0" />
              <asp:parameter name="_ret" type="Int32" direction="ReturnValue" defaultvalue="0" />
            </selectparameters>
        </asp:sqldatasource>
        <!--
          CREATE PROCEDURE dbo.getordertotal
            @empId int,
            @total int OUTPUT
          as
            set nocount on
            select @total    = count(1) from orders where employeeid=@empid;
            select * from orders where employeeID = @empId ;
            return (-1000);
          GO
        -->

        <asp:gridview
          id="GridView1"
          runat="server"
          allowpaging="True"
          pagesize="5"
          datasourceid="SqlDataSource1" />

        <asp:button
          id="Button1"
          runat="server"
          onclick="Submit"
          text="Refresh Data" />

        <asp:label id="Label1" runat="server" />

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

Commenti

La SqlDataSourceStatusEventArgs classe viene utilizzata negli Selectedeventi , Updated, Insertede Deleted per passare informazioni su un'operazione di database dopo che viene eseguita dal controllo origine dati. Queste informazioni includono il numero di righe interessate dall'operazione, l'oggetto DbCommand utilizzato dall'origine dati per eseguire l'operazione e le informazioni sulle eccezioni risultanti. Aggiungendo un delegato del gestore eventi per gestire gli Selectedeventi , Updated Inserted o Deleted , è possibile esaminare questi dati ed eseguire eventuali operazioni di post-elaborazione aggiuntive necessarie.

Il SqlDataSource controllo espone molti eventi che è possibile gestire per lavorare con gli oggetti dati sottostanti durante il corso di un'operazione sui dati. Nella tabella seguente sono elencati gli eventi e le classi del gestore eventi e associati EventArgs , per guidare meglio i vari eventi che corrispondono al ciclo di vita di un'operazione di dati usando il SqlDataSource controllo .

Evento	EventArgs	Eventhandler
Selecting si verifica prima del recupero dei dati.	SqlDataSourceSelectingEventArgs	SqlDataSourceSelectingEventHandler
Inserting, Updating, Deleting si verificano prima dell'esecuzione di un'operazione di inserimento, aggiornamento o eliminazione.	SqlDataSourceCommandEventArgs	SqlDataSourceCommandEventHandler
Selected, Inserted, Updated, Deleted si verificano dopo il completamento delle operazioni di recupero, inserimento, aggiornamento o eliminazione dei dati.	SqlDataSourceStatusEventArgs	SqlDataSourceStatusEventHandler

Costruttori

SqlDataSourceStatusEventArgs(DbCommand, Int32, Exception)

Inizializza una nuova istanza della classe SqlDataSourceStatusEventArgs utilizzando i parametri di output specificati, il valore restituito e il numero di righe interessate dall'operazione sul database.

Proprietà

AffectedRows	Ottiene il numero di righe interessate dall'operazione sul database.
Command	Ottiene il comando di database inviato al database.
Exception	Ottiene un wrapper per le eccezioni generate dal database durante un'operazione sui dati.
ExceptionHandled	Ottiene o imposta un valore indicante se un'eccezione generata dal database è stata gestita.

Metodi

Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)

Si applica a