利用 DataSet 存取 SQL Server 二進位檔案 (BLOB) 完整範例 (VB.NET)

環境設定

建立測試資料表

CREATE TABLE tb_test (
    id INT IDENTITY(1,1),
    photo IMAGE,
    CONSTRAINT pk_tb_test PRIMARY KEY(id)
)

使用 IMAGE 資料類型儲存二進位檔案 (最大 2GB)。

功能一：將本機檔案儲存至資料庫

Imports System.IO
Imports System.Data.SqlClient

Public Class ImageHandler
    Shared Sub SaveImageToDatabase()
        ' 1. 讀取檔案為位元組陣列
        Dim fs As New FileStream("c:\1.jpg", FileMode.Open, FileAccess.Read)
        Dim imgData(fs.Length - 1) As Byte
        fs.Read(imgData, 0, fs.Length)
        fs.Close()

        ' 2. 建立資料庫連線與 DataAdapter
        Dim tempConnection As New SqlConnection
        Dim tempAdapter As SqlDataAdapter
        Dim tempDataSet As New DataSet

        tempConnection.ConnectionString = "server=s_test;uid=sa;pwd=7890;database=db_test"
        tempConnection.Open()

        ' 使用 WHERE 1=0 只取結構不取資料
        tempAdapter = New SqlDataAdapter("SELECT * FROM tb_test WHERE 1=0", tempConnection)
        Dim cb As New SqlCommandBuilder(tempAdapter)  ' 自動產生 INSERT/UPDATE/DELETE 命令
        tempAdapter.Fill(tempDataSet)

        ' 3. 新增資料列並更新
        Dim tempDataRow As DataRow = tempDataSet.Tables(0).NewRow()
        tempDataRow("photo") = imgData
        tempDataSet.Tables(0).Rows.Add(tempDataRow)
        tempAdapter.Update(tempDataSet)  ' 觸發 INSERT 命令

        tempConnection.Close()
    End Sub
End Class

功能二：從資料庫讀取檔案存至本機

Shared Sub LoadImageFromDatabase()
    Dim tempConnection As New SqlConnection
    Dim tempAdapter As SqlDataAdapter
    Dim tempDataSet As New DataSet

    tempConnection.ConnectionString = "server=s_test;uid=sa;pwd=7890;database=db_test"
    tempConnection.Open()

    tempAdapter = New SqlDataAdapter("SELECT * FROM tb_test", tempConnection)
    tempAdapter.Fill(tempDataSet)

    ' 讀取第一筆資料的 photo 欄位
    If tempDataSet.Tables(0).Rows.Count > 0 Then
        Dim imgData As Byte() = CType(tempDataSet.Tables(0).Rows(0)("photo"), Byte())
        
        ' 寫入檔案
        Dim fs As New FileStream("c:\2.jpg", FileMode.Create, FileAccess.Write)
        fs.Write(imgData, 0, imgData.Length)
        fs.Close()
    End If

    tempConnection.Close()
End Sub

核心架構解析

關鍵技術要點

• 離線架構優勢：DataSet 在記憶體操作，更新時才連線，減少連線佔用
• SqlCommandBuilder 自動命令產生：需 SelectCommand 為單一資料表且有主鍵，否則需手寫命令
• IMAGE/VARBINARY(MAX) 欄位對應：.NET 對應 Byte() 陣列
• 大檔案考量：超大檔案建議使用 SqlCommand.ExecuteNonQuery 搭配參數化查詢分塊寫入，避免記憶體壓力
• 資料流處理：FileStream.Read/Write 需正確處理位元組長度與位移

常見問題與解決

1. 上一篇文章： C++Builder 客戶端呼叫預存程序遠端備份 SQL Server 資料庫實作
2. 下一篇文章： SQL Server 啟動時自動執行預存程序設定指南

關於SqlServer

GridView 自定義分頁四種存儲過程寫法深度對比：TOP、臨時表、表變量、ROW_NUMBER() 性能與適用場景

ASP.NET WebForms 時代，GridView 內

SQL Server 登錄審計實戰：Logon Trigger + BCP 記錄登入時間，含 DAC 緊急救援指南

需求 記錄所有 SQL Server 登入帳號與時間，防範竄

SQL 進階分組統計實戰：分組合計、總計、Top-N、首條記錄、多維匯總完全指南

本文系統整理 12 個經典分組統計場景，涵蓋：分組後求總記錄

SQL Server 資料壓縮完整指南：ROW vs PAGE 壓縮、效能權衡與最佳實務

為什麼需要壓縮？ 查詢瓶頸三大金剛：CPU、記憶體、磁碟 I