SqlDataSourceStatusEventArgs Kelas

Referensi

Definisi

Ruang nama:: System.Web.UI.WebControls

Rakitan:: System.Web.dll

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Menyediakan data untuk peristiwa yang dinaikkan oleh SqlDataSource kontrol setelah operasi data selesai.

public ref class SqlDataSourceStatusEventArgs : EventArgs

public class SqlDataSourceStatusEventArgs : EventArgs

type SqlDataSourceStatusEventArgs = class
    inherit EventArgs

Public Class SqlDataSourceStatusEventArgs
Inherits EventArgs

Warisan: Object

EventArgs
SqlDataSourceStatusEventArgs

Contoh

Contoh kode berikut menunjukkan cara menggunakan SqlDataSourceStatusEventArgs kelas untuk memeriksa nilai pengembalian dan nilai parameter output yang dikembalikan saat menggunakan SqlDataSource kontrol dengan prosedur tersimpan untuk mengisi GridView kontrol. Prosedur tersimpan memilih data yang ditampilkan di GridView, tetapi juga meneruskan informasi lain kembali ke pemanggil, seperti parameter output bilangan bulat dan nilai yang dikembalikan. Parameter yang SqlDataSource digunakan untuk prosedur tersimpan dimuat oleh SelectParameters koleksi, dan terdiri dari parameter yang meneruskan informasi dari formulir Web ke prosedur tersimpan serta parameter yang meneruskan informasi kembali ke formulir. Properti Direction parameter ini diatur ke Output dan 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>

Keterangan

Kelas SqlDataSourceStatusEventArgs digunakan dalam Selectedperistiwa , Updated, Inserted, dan Deleted untuk meneruskan informasi tentang operasi database setelah dilakukan oleh kontrol sumber data. Informasi ini mencakup jumlah baris yang terpengaruh oleh operasi, DbCommand objek yang digunakan sumber data untuk melakukan operasi, dan informasi pengecualian apa pun yang dihasilkan. Dengan menambahkan delegasi penanganan aktivitas untuk menangani Selectedperistiwa , , Updated Inserted atau Deleted , Anda dapat memeriksa data ini dan melakukan pemrosesan pasca tambahan yang diperlukan.

Kontrol ini SqlDataSource memaparkan banyak peristiwa yang dapat Anda tangani untuk bekerja dengan objek data yang mendasar selama operasi data. Tabel berikut mencantumkan peristiwa dan kelas penanganan aktivitas dan terkait EventArgs , untuk memandu Anda dengan lebih baik ke berbagai peristiwa yang sesuai dengan siklus hidup operasi data menggunakan SqlDataSource kontrol.

Kejadian	EventArgs	EventHandler
Selecting terjadi sebelum data diambil.	SqlDataSourceSelectingEventArgs	SqlDataSourceSelectingEventHandler
Inserting, Updating, Deleting terjadi sebelum operasi sisipkan, perbarui, atau hapus dilakukan.	SqlDataSourceCommandEventArgs	SqlDataSourceCommandEventHandler
Selected, , Inserted Updated, Deleted terjadi setelah operasi pengambilan data, sisipkan, perbarui, atau hapus selesai.	SqlDataSourceStatusEventArgs	SqlDataSourceStatusEventHandler

Konstruktor

SqlDataSourceStatusEventArgs(DbCommand, Int32, Exception)

Menginisialisasi instans SqlDataSourceStatusEventArgs baru kelas, menggunakan parameter output yang ditentukan, nilai pengembalian, dan jumlah baris yang terpengaruh oleh operasi database.

Properti

AffectedRows	Mendapatkan jumlah baris yang terpengaruh oleh operasi database.
Command	Mendapatkan perintah database yang dikirimkan ke database.
Exception	Mendapatkan pembungkus untuk pengecualian apa pun yang dilemparkan oleh database selama operasi data.
ExceptionHandled	Mendapatkan atau menetapkan nilai yang menunjukkan apakah pengecualian yang dilemparkan oleh database telah ditangani.

Metode

Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetType()	Mendapatkan instans Type saat ini. (Diperoleh dari Object)
MemberwiseClone()	Membuat salinan dangkal dari yang saat ini Object. (Diperoleh dari Object)
ToString()	Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object)

Berlaku untuk