[ADO.NET] Command 物件 -- Draft

表示要對 SQL Server 資料庫執行的 Transact-SQL 陳述式或預存程序。
Command 物件是用來對資料來源執行SQL命令：選取Select、新增Insert、修改Update、刪除Delete。

Command 物件主要透過二種方式來執行SQL語法：

1. ExecuteReader()方法：適合select查詢語句，通過Reader取得對應的值
2. ExecuteNonQuery()方法：適合新刪修update、insert、delete語句，回傳受影響的資料筆數

ExecuteScalar從資料庫取得單一值，通常用在要傳回彙總函式的結果(conut(*),sum(price))

1. ExecuteReader()

與DataReader搭配使用，將SQL語法執行結果 傳給ExecuteReader()物件。
此法專注於Select 命令「查詢結果」。

範例

string connString = "Data Source=.;Initial catalog=DBTEST;User id=riva;Password=1234;Encrypt=true;TrustServerCertificate=True";

//建立與sql server的連線
using (SqlConnection conn = new SqlConnection(connString))
{
    //開啟資料庫連線
    if (conn.State != ConnectionState.Open) conn.Open();

    //準備SQL語句(select)
    SqlCommand cmd = new SqlCommand("select * from Employee", conn);

    //執行SQL語句，並接收execute傳回的資料
    using (SqlDataReader dr = cmd.ExecuteReader())
    {
        //檢查是否有資料
        if (dr.HasRows) //HasRows=有資料行
        {
            //使用Read()方法把資料讀進dr (Read會讀取一行的資料)
            while (dr.Read()) //遍歷所有記錄 (使用while讀到不能讀為止)
            {
                //讀取數據，並將其寫入主控台
                Console.WriteLine($"{dr[0]},{dr[1]},{dr[2]}");
            }
        } else
        {
            Console.WriteLine("No rows found.");
        }
    }
}

• HasRows：表示目前行SqlDataReader是否包含一行或多行，用來判斷是否有讀到資料 (HasRows=有資料行)
• Read()：使得目前SqlDataReader 前進到下一筆記錄，即向前讀取。(Read 會讀取一行的資料)
• While(dr.Reader()) //遍歷所有記錄 (使用while 讀到不能讀為止)

執行結果：

1,Ken,男
2,Ben,男
3,Tim,男

2. ExecuteNonQuery()

此法不回傳資料錄。
但可回傳異動(Insert、Update、Delete)的資料筆數。(Select返回-1)
專注於：資料的新增Insert、修改Update、刪除Delete。

範例1 (select)

string connString = "Data Source=.;Initial catalog=DBTEST;User id=riva;Password=1234;Encrypt=true;Trust Server Certificate=True";

//建立與sql server的連線
using (SqlConnection conn = new SqlConnection(connString))
{
    //開啟資料庫連線
    if (conn.State != ConnectionState.Open) conn.Open();

    //準備SQL語句(select)
    SqlCommand cmd = new SqlCommand("select * from Employee", conn);

    //執行SQL語句(如果只是想執行SQL，不關心回傳內容的話，可以呼叫ExecuteNonQuery方法)
    int result = cmd.ExecuteNonQuery(); //回傳值是-1, insert,update,delete是回傳異動的資料筆數
}

範例2: (update)

• 使用SqlCommand執行更新資料動作
• 所以會使用ExecuteNoQuery()方法(會返回異動筆數)

SQL語句正確寫法是要配合使用參數寫法：@參數名稱 加上 SqlParameter 的方式放入(不可以偷懶)，避免 SQL Injection 攻擊

string connString = "Data Source=.;Initial catalog=DBTEST;User id=riva;Password=1234;Encrypt=true;Trust Server Certificate=True";

//建立與sql server的連線
using (SqlConnection conn = new SqlConnection(connString))
{
    //開啟資料庫連線
    if (conn.State != ConnectionState.Open) conn.Open();

    //準備SQL語句
    string sql = @"update emp set EmpName = @EmpName where EmpId = @EmpId";

    //SQL語句(正確寫法是要 配合使用參數寫法，避免 SQL Injection 攻擊 --  @參數名稱+SqlParameter 的方式放入)
    //string sql = @"update emp set EmpName = 'OOO' where EmpId = 1";

    //告訴SqlCommand 要執行的SQL 和 要連的db
    using (SqlCommand cmd = new SqlCommand(sql, conn))
    { 
        //定義參數和要傳入的值
        cmd.Parameters.AddWithValue("@EmpId", 1);
        cmd.Parameters.AddWithValue("@EmpName", "張三");

        // 1代表 異動筆數共有一筆，代表更新成功
        if (cmd.ExecuteNonQuery() == 1)
        {
            Console.WriteLine("更新成功");
        } else
        {
            Console.WriteLine("更新失敗");
        }
    }
}

ExcuteNonQuery()回傳的結果是什麼？

• 第一種情況：用於update、insert、delete語句中傳回該受影響的行數 (異動的資料筆數)。
• 第二種情況：用於select語句傳回值為-1。

對於 ExcuteNonQuery的回傳值，微軟在官方文件中給出了這樣的描述：MSDN

對於 UPDATE、INSERT 和 DELETE 語句，傳回值為該指令所影響的行數。對於所有其他類型的語句，傳回值是 -1。

所以SELECT這裡的回傳值是-1。

ExecuteScalar (取得單一值)

從資料庫取得單一值
使用 ExecuteScalar 物件的 Command 方法，從資料庫查詢傳回單一值。

或許您需要以單一數值傳回資料庫資訊，而非以資料表或資料流的形式。

• 例如，您或許要傳回彙總函式 (例如 COUNT(*)、SUM(Price) 或 AVG(Quantity)) 的結果。
• Command 物件可讓您以 ExecuteScalar 方法傳回單一數值。
• ExecuteScalar 方法會將結果集第一個資料列之第一個資料行的值當做純量值傳回。

MSDN - SqlCommand.ExecuteNonQuery 方法
MSDN - SqlCommand 類別
MSDN - SqlDataReader 類別
MSDN - 執行命令
MSDN - 從資料庫取得單一值