[ADO.NET] DataReader的 RecordsAffected屬性 / 新增、刪除、修改的 .ExecuteNonQuery()方法之傳回值

RecordsAffected屬性 (微軟官方的 MSDN網站,解釋如下)
取得 Transact-SQL 陳述式的執行所變更、插入或刪除的資料列數目。
變更、插入或刪除的資料列數目;如果沒有任何資料列受影響或陳述式失敗,則為 0;SELECT 陳述式則為 -1。






[ADO.NET] DataReader的 RecordsAffected屬性


建議各位還是參閱微軟官方的 MSDN網站最清楚了。
資料來源: http://msdn.microsoft.com/zh-tw/library/system.data.sqlclient.sqldatareader.recordsaffected.aspx

可以作為 ASP.NET專題實務(上集)的 Ch. 14章 一點小小補充



RecordsAffected屬性
取得 Transact-SQL 陳述式的執行所變更、插入或刪除的資料列數目。

屬性值
型別:System.Int32
變更、插入或刪除的資料列數目;如果沒有任何資料列受影響或陳述式失敗,則為 0;SELECT 陳述式則為 -1

 

我對上面這句話比較感興趣。

另外他強調了三件事:

RecordsAffected 屬性會在所有資料列已讀取,且您關閉 SqlDataReader 之後才會設定。

這個屬性值為累計。例如,如果兩個資料錄插入於批次模式,則 RecordsAffected 的值將是二。
 
IsClosed 和 RecordsAffected 是在關閉 SqlDataReader 之後,您唯一可以呼叫的屬性。

 

=========================================

<<行前練習>>

以下的範例,都使用到這個簡單的觀念,請參考:

初探ADO.NET #1,程式與資料庫互動的四大步驟
http://www.dotblogs.com.tw/mis2000lab/archive/2008/08/15/4918.aspx

 

如果您沒有看過書,或是對於 ADO.NET沒底子,最好先把這幾篇文章看完再說:

ADO.NET入門文章(書本文章公開 / 下載)#1 -- 各種基礎範例
http://www.dotblogs.com.tw/mis2000lab/archive/2011/01/14/ado_net_book_sample_20110114.aspx


ADO.NET入門文章(書本文章公開 / 下載)#2 -- Stored Procedure / NextResult方法 / MARS
http://www.dotblogs.com.tw/mis2000lab/archive/2011/01/14/ado_net_book_sample_2_20010114.aspx


ADO.NET入門文章(書本文章公開 / 下載)#3 -- MARS與簡單的「留言版」範例
http://www.dotblogs.com.tw/mis2000lab/archive/2011/01/14/ado_net_book_sample_3_20111114.aspx

 

 

 


=========================================


<<範例一>>

以前,我們都知道,撰寫「新增」、「刪除」、「修改」的SQL指令時,
需要使用 SqlCommand的 .ExecuteNonQuery()方法

完成後,他會傳回一個整數值,代表「這個指令影響了幾列紀錄」。

簡單的範例如下:


'----自己(宣告)寫的----
Imports System
Imports System.Web.Configuration
Imports System.Data
Imports System.Data.SqlClient
'----自己(宣告)寫的----


    Protected Sub Page_Load(sender As Object, e As System.EventArgs) Handles Me.Load
        '== (1). 開啟資料庫的連結。
        Dim Conn As New SqlConnection(WebConfigurationManager.ConnectionStrings("Web.Config檔裡面的DB連結字串").ConnectionString)
        Conn.Open()

        '== (2). 執行SQL指令。或是查詢、撈取資料。
        Dim cmd As SqlCommand = New SqlCommand("Update test set title = '真珠草萃取物可以治療肝炎 韓國技轉錦鴻' where id =3", Conn)


        '== (3). 自由發揮。
        Dim RecordsAffected As Integer = cmd.ExecuteNonQuery()

        Label1.Text = "執行 Update的SQL指令以後,影響了" & RecordsAffected & "列的紀錄。"

'-- 或者是,您可以這樣寫,代表有更動到一些紀錄。

' If RecordsAffected > 0 Then
'    Response.Write("資料更動成功。共有" & RecordsAffected  & "列紀錄被影響。")
' End If


        '== (4). 釋放資源、關閉資料庫的連結。
        cmd.Cancel()

        If (Conn.State = ConnectionState.Open) Then
            Conn.Close()
            Conn.Dispose()
        End If
    End Sub

 



=========================================


<<範例二>>

而 SqlDataReader的 RecordsAffected屬性
在MSDN網站上有強調兩件事:

        '== 重點(1)    IsClosed屬性和 RecordsAffected屬性是在關閉 SqlDataReader之後,您還可以呼叫的兩個屬性。

        '== 重點(2)    使用Select陳述式則 RecordsAffected屬性為 -1


寫了一個簡單範例,真的是如此。



'----自己(宣告)寫的----
Imports System
Imports System.Web.Configuration
Imports System.Data
Imports System.Data.SqlClient
'----自己(宣告)寫的----


Partial Class _Book_New_Samples_DB_DataReader_RecordsAffected_02
    Inherits System.Web.UI.Page

    Protected Sub Page_Load(sender As Object, e As System.EventArgs) Handles Me.Load
        '== (1). 開啟資料庫的連結。
        Dim Conn As New SqlConnection(WebConfigurationManager.ConnectionStrings("Web.Config檔裡面的DB連結字串").ConnectionString)
        Conn.Open()

        '== (2). 執行SQL指令。或是查詢、撈取資料。
        Dim cmd As SqlCommand = New SqlCommand("Select * From test", Conn)
        Dim dr As SqlDataReader = cmd.ExecuteReader()

        '== (3). 自由發揮。把撈出來的紀錄,呈現在畫面上。
        GridView1.DataSource = dr
        GridView1.DataBind()

        '== (4). 釋放資源、關閉資料庫的連結。
        If Not (dr Is Nothing) Then
            cmd.Cancel()
            dr.Close()
        End If

        '******************************
        Label1.Text = "執行 Select 的SQL指令以後,影響了" & dr.RecordsAffected & "列的紀錄。"
        '== 重點(1)    IsClosed屬性和 RecordsAffected屬性是在關閉 SqlDataReader之後,您還可以呼叫的兩個屬性。
        '== 重點(2)    使用Select陳述式則 RecordsAffected屬性為(-1)
        '******************************


        If (Conn.State = ConnectionState.Open) Then
            Conn.Close()
            Conn.Dispose()
        End If
    End Sub

 

 

 

 

 

 

 

 

 

 

 

 

今日值班正妹,林志玲

圖片來源:  http://www.nownews.com/photo/photo.php?phid=6872#tphoto

 

 

 

 

 

 

 

 

我將思想傳授他人, 他人之所得,亦無損於我之所有;

猶如一人以我的燭火點燭,光亮與他同在,我卻不因此身處黑暗。----Thomas Jefferson

線上課程教學,遠距教學 (Web Form 約 51hr)  https://dotblogs.com.tw/mis2000lab/2016/02/01/aspnet_online_learning_distance_education_VS2015

線上課程教學,遠距教學 (ASP.NET MVC 約 140hr)  https://dotblogs.com.tw/mis2000lab/2018/08/14/ASPnet_MVC_Online_Learning_MIS2000Lab

 

寫信給我,不要私訊 --  mis2000lab (at) yahoo.com.tw  或  school (at) mis2000lab.net

 (1) 第一天 ASP.NET MVC5 完整影片(5.5小時 / .NET 4.x版)免費試聽。影片 https://youtu.be/9spaHik87-A 

 (2) 第一天 ASP.NET Core MVC 完整影片(3小時 / .NET Core 6.0~8.0)免費試聽。影片 https://youtu.be/TSmwpT-Bx4I 

[學員感言] mis2000lab課程評價 - ASP.NET MVC , WebForm  。 https://mis2000lab.medium.com/%E5%AD%B8%E5%93%A1%E6%84%9F%E8%A8%80-mis2000lab%E8%AA%B2%E7%A8%8B%E8%A9%95%E5%83%B9-asp-net-mvc-webform-77903ce9680b  


ASP.NET遠距教學、線上課程(Web Form + MVC)。 第一天課程, "完整" 試聽。 

.........   facebook社團   https://www.facebook.com/mis2000lab   ......................

.........  YouTube (ASP.NET) 線上教學影片  https://www.youtube.com/channel/UC6IPPf6tvsNG8zX3u1LddvA/

 

Blog文章 "附的範例" 無法下載,請看 https://dotblogs.com.tw/mis2000lab/2016/03/14/2008_2015_mis2000lab_sample_download

請看我們的「售後服務」範圍(嚴格認定)。

...................................................................................................................................................... 

ASP.NET MVC  => .NET Core MVC 線上教學  ...... 第一天課程 完整內容 "免費"讓您評估 / 試聽

[遠距教學、教學影片] ASP.NET (Web Form) 課程 上線了!MIS2000Lab.主講   事先錄好的影片,並非上課側錄!   觀看時,有如「一對一」面對面講課