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.主講 事先錄好的影片,並非上課側錄! 觀看時,有如「一對一」面對面講課。