共用方式為


DbDataAdapter.Update 方法

定義

針對 DataSet 中的每個插入、更新或刪除的資料列,執行個別的 INSERT、UPDATE 或 DELETE 陳述式,以更新資料庫中的值。

多載

Update(DataSet, String)

針對具有指定 DataTable 名稱之 DataSet 中的每個插入、更新或刪除的資料列,執行個別的 INSERT、UPDATE 或 DELETE 陳述式,以更新資料庫中的值。

Update(DataRow[], DataTableMapping)

針對 DataRow 物件的指定陣列中每個插入、更新或刪除的資料列,執行個別的 INSERT、UPDATE 或 DELETE 陳述式,以更新資料庫中的值。

Update(DataTable)

針對指定之 DataTable 中的每個插入、更新或刪除的資料列,執行個別的 INSERT、UPDATE 或 DELETE 陳述式,以更新資料庫中的值。

Update(DataSet)

針對指定之 DataSet 中的每個插入、更新或刪除的資料列,執行個別的 INSERT、UPDATE 或 DELETE 陳述式,以更新資料庫中的值。

Update(DataRow[])

針對 DataSet 的指定陣列中每個插入、更新或刪除的資料列,執行個別的 INSERT、UPDATE 或 DELETE 陳述式,以更新資料庫中的值。

Update(DataSet, String)

來源:
DbDataAdapter.cs
來源:
DbDataAdapter.cs
來源:
DbDataAdapter.cs

針對具有指定 DataTable 名稱之 DataSet 中的每個插入、更新或刪除的資料列,執行個別的 INSERT、UPDATE 或 DELETE 陳述式,以更新資料庫中的值。

public:
 int Update(System::Data::DataSet ^ dataSet, System::String ^ srcTable);
public int Update (System.Data.DataSet dataSet, string srcTable);
override this.Update : System.Data.DataSet * string -> int
Public Function Update (dataSet As DataSet, srcTable As String) As Integer

參數

dataSet
DataSet

用來更新資料來源的 DataSet

srcTable
String

用於資料表對應的來源資料表名稱。

傳回

DataSet 中成功更新的資料列數目。

例外狀況

來源資料表無效。

嘗試執行 INSERT、UPDATE 或 DELETE 陳述式會造成沒有資料錄受影響。

範例

下列範例會使用衍生類別 OleDbDataAdapter,來更新數據源。

public DataSet CreateCmdsAndUpdate(string connectionString,
    string queryString, string tableName)
{
    using (OleDbConnection connection = new OleDbConnection(connectionString))
    {
        OleDbDataAdapter adapter = new OleDbDataAdapter();
        adapter.SelectCommand = new OleDbCommand(queryString, connection);
        OleDbCommandBuilder builder = new OleDbCommandBuilder(adapter);

        connection.Open();

        DataSet customers = new DataSet();
        adapter.Fill(customers);

        //code to modify data in dataset here

        adapter.Update(customers, tableName);

        return customers;
    }
}
Public Function CreateCmdsAndUpdate(ByVal connectionString As String, _
    ByVal queryString As String, _
    ByVal tableName As String) As DataSet

    Using connection As New OleDbConnection(connectionString)
        Dim adapter As New OleDbDataAdapter()
        adapter.SelectCommand = New OleDbCommand(queryString, connection)
        Dim builder As New OleDbCommandBuilder(adapter)

        connection.Open()

        Dim customers As New DataSet()
        adapter.Fill(customers)

        ' Code to modify data in DataSet here 

        adapter.Update(customers, tableName)

        Return customers
    End Using
End Function

備註

當應用程式呼叫 Update 方法時,會 DbDataAdapter 檢查 RowState 屬性,並根據 中所 DataSet設定的索引順序,反覆執行每個數據列的必要 INSERT、UPDATE 或 DELETE 語句。 例如, Update 可能會執行 DELETE 語句,後面接著 INSERT 語句,然後執行另一個 DELETE 語句,因為 中 DataTable數據列的順序。

請注意,這些語句不會以批處理方式執行;每個數據列都會個別更新。 應用程式可以在您必須控制語句類型序列的情況下呼叫 GetChanges 方法,例如,UPDATE) 之前,先 (INSERT。 如需詳細資訊,請參閱使用 DataAdapters 更新資料來源

如果未指定 INSERT、UPDATE 或 DELETE 語句,此方法 Update 會產生例外狀況。 不過,如果您設定 SelectCommand .NET Framework 數據提供者的 屬性,您可以建立 SqlCommandBuilderOleDbCommandBuilder 對象來自動產生單一數據表更新的 SQL 語句。 然後,您未設定的任何其他 SQL 語句都會由 CommandBuilder 產生。 此產生邏輯需要中 DataSet存在索引鍵數據行資訊。 如需詳細資訊,請參閱 使用 CommandBuilders 產生命令

方法 Update 支援的案例,其中 DataSet 包含多個 DataTable 對象的名稱只依大小寫而有所不同。 當多個具有相同名稱但不同大小寫的數據表存在於 中DataSetUpdate時,會執行區分大小寫的比較來尋找對應的數據表,並在沒有完全相符專案時產生例外狀況。 下列 C# 程式代碼說明此行為。

DataSet ds = new DataSet();  
 ds.Tables.Add("aaa");  
 ds.Tables.Add("AAA");  
 adapter.Update(ds, "aaa"); // Updates "aaa", which already exists in the DataSet.  
 adapter.Update(ds, "AAA"); // Updates "AAA", which already exists in the DataSet.  
    adapter.Update(ds, "Aaa"); // Results in an exception.  

如果 Update 呼叫 ,且 DataSetDataTable 包含名稱只依大小寫 DataTable 而不同之名稱的 ,則會更新。 在此案例中,比較不區分大小寫。 下列 C# 程式代碼說明此行為。

DataSet dataset = new DataSet();  
 dataset.Tables.Add("aaa");  
    adapter.Update(dataset, "AAA"); // Updates table "aaa" because only one similarly named table is in the DataSet.  

方法會 Update 先從第一個對應中列出的數據表擷取數據列,再執行更新。 Update然後使用 屬性的值UpdatedRowSource重新整理數據列。 會忽略傳回的任何其他數據列。

載入回 DataSet的任何數據之後, OnRowUpdated 就會引發 事件,讓使用者能夠檢查已協調 DataSet 的數據列和命令傳回的任何輸出參數。 成功更新數據列之後,就會接受該數據列的變更。

使用 Update時,執行順序如下:

  1. 中的 DataRow 值會移至參數值。

  2. 便會引發 OnRowUpdating 事件。

  3. 命令會執行。

  4. 如果命令設定 FirstReturnedRecord為 ,則第一個傳回的結果會放在 中 DataRow

  5. 如果有輸出參數,它們會放在 中 DataRow

  6. 便會引發 OnRowUpdated 事件。

  7. 呼叫 AcceptChanges

與相關聯的 DbDataAdapter 每個命令通常都有與其相關聯的參數集合。 參數會透過 SourceColumn .NET Framework 數據提供者類別Parameter的 和 SourceVersion 屬性,對應至目前的數據列。 SourceColumnDataTableDbDataAdapter參考以取得目前數據列之參數值的數據行。

SourceColumn 在套用任何數據表對應之前,會參考未對應的數據行名稱。 如果 SourceColumn 參考不存在的數據行,所採取的動作取決於下列 MissingMappingAction 其中一個值。

列舉值 已採取的動作
MissingMappingAction.Passthrough 如果沒有對應,請使用 中的 DataSet 源數據行名稱和數據表名稱。
MissingMappingAction.Ignore 會產生。SystemException 明確設定對應時,輸入參數遺漏的對應通常是錯誤的結果。
MissingMappingAction.Error 會產生。SystemException

屬性 SourceColumn 也可用來將輸出或輸入/輸出參數的值對應回 DataSet。 如果例外狀況參考不存在的數據行,就會產生例外狀況。

SourceVersion.NET Framework 數據提供者類別Parameter的 屬性會決定要使用數據行值的原始、目前或建議版本。 這項功能通常用於在 UPDATE 語句的 WHERE 子句中包含原始值,以檢查開放式並行存取違規。

注意

如果在更新數據列時發生錯誤,則會擲回例外狀況,並停止更新的執行。 若要在遇到錯誤時繼續更新作業而不產生例外狀況,請在呼叫 之前將 ContinueUpdateOnError 屬性設定為 trueUpdate 您也可以在 DataAdapter 事件內 RowUpdated ,根據每個數據列回應錯誤。 若要繼續更新作業,而不在事件內 RowUpdated 產生例外狀況,請將 StatusRowUpdatedEventArgs 屬性設定為 Continue

另請參閱

適用於

Update(DataRow[], DataTableMapping)

來源:
DbDataAdapter.cs
來源:
DbDataAdapter.cs
來源:
DbDataAdapter.cs

針對 DataRow 物件的指定陣列中每個插入、更新或刪除的資料列,執行個別的 INSERT、UPDATE 或 DELETE 陳述式,以更新資料庫中的值。

protected:
 virtual int Update(cli::array <System::Data::DataRow ^> ^ dataRows, System::Data::Common::DataTableMapping ^ tableMapping);
protected virtual int Update (System.Data.DataRow[] dataRows, System.Data.Common.DataTableMapping tableMapping);
override this.Update : System.Data.DataRow[] * System.Data.Common.DataTableMapping -> int
Protected Overridable Function Update (dataRows As DataRow(), tableMapping As DataTableMapping) As Integer

參數

dataRows
DataRow[]

用來更新資料來源的 DataRow 物件陣列。

tableMapping
DataTableMapping

要使用的 TableMappings 集合。

傳回

從物件的陣列成功更新的數據列 DataRow 數目。

例外狀況

來源資料表無效。

要更新的 DataRow 不存在。

-或-

要更新的 DataTable 不存在。

-或-

要用來做為來源的 DataSet 不存在。

嘗試執行 INSERT、UPDATE 或 DELETE 陳述式會造成沒有資料錄受影響。

備註

當應用程式呼叫 Update 方法時,會 DbDataAdapter 檢查 RowState 屬性,並根據 中所 DataSet設定的索引順序,反覆執行每個數據列的必要 INSERT、UPDATE 或 DELETE 語句。 例如, Update 可能會執行 DELETE 語句,後面接著 INSERT 語句,然後執行另一個 DELETE 語句,因為 中 DataTable數據列的順序。

請注意,這些語句不會以批處理方式執行;每個數據列都會個別更新。 應用程式可以在您必須控制語句類型的序列的情況下呼叫 GetChanges 方法,例如,在UPDATEEs) 之前,INSERT (。 如需詳細資訊,請參閱使用 DataAdapters 更新資料來源

如果未指定 INSERT、UPDATE 或 DELETE 語句,此方法 Update 會產生例外狀況。 不過,如果您設定 SelectCommand .NET Framework 數據提供者的 屬性,您可以建立 SqlCommandBuilderOleDbCommandBuilder 對象來自動產生單一數據表更新的 SQL 語句。 然後,您未設定的任何其他 SQL 語句都會由 CommandBuilder 產生。 此產生邏輯需要中 DataSet存在索引鍵數據行資訊。 如需詳細資訊,請參閱 使用 CommandBuilders 產生命令

方法會 Update 先從第一個對應中列出的數據表擷取數據列,再執行更新。 Update然後使用 屬性的值UpdatedRowSource重新整理數據列。 會忽略傳回的任何其他數據列。

載入回 DataSet的任何數據之後, OnRowUpdated 就會引發 事件,讓使用者能夠檢查已協調 DataSet 的數據列和命令傳回的任何輸出參數。 成功更新數據列之後,就會接受該數據列的變更。

使用 Update時,執行順序如下:

  1. 中的 DataRow 值會移至參數值。

  2. 便會引發 OnRowUpdating 事件。

  3. 命令會執行。

  4. 如果命令設定為 FirstReturnedRecord,則會將 DataRow第一個傳回的結果放在 中。

  5. 如果有輸出參數,它們會放在 中 DataRow

  6. 便會引發 OnRowUpdated 事件。

  7. 呼叫 AcceptChanges

與相關聯的 DbDataAdapter 每個命令通常會有與其相關聯的參數集合。 參數會透過 SourceColumn .NET Framework 數據提供者類別Parameter的 和 SourceVersion 屬性,對應至目前的數據列。 SourceColumnDataTableDbDataAdapter是指參考以取得目前數據列之參數值的數據行。

SourceColumn 是指套用任何數據表對應之前未對應的數據行名稱。 如果 SourceColumn 參考不存在的數據行,所採取的動作取決於下列 MissingMappingAction 其中一個值。

列舉值 已採取的動作
MissingMappingAction.Passthrough 如果沒有對應,請使用 中的 DataSet 源數據行名稱和數據表名稱。
MissingMappingAction.Ignore 產生。SystemException 明確設定對應時,輸入參數遺漏的對應通常是錯誤的結果。
MissingMappingAction.Error 產生。SystemException

屬性 SourceColumn 也可用來將輸出或輸入/輸出參數的值對應回 DataSet。 如果例外狀況參考不存在的數據行,就會產生例外狀況。

SourceVersion.NET Framework 資料提供者類別的 Parameter 屬性會決定要使用數據行值的原始、目前或建議版本。 這項功能通常用來在 UPDATE 語句的 WHERE 子句中包含原始值,以檢查開放式並行存取違規。

注意

如果在更新數據列時發生錯誤,則會擲回例外狀況,並停止執行更新。 若要在發生錯誤時繼續更新作業而不產生例外狀況,請在呼叫 之前將 ContinueUpdateOnError 屬性設定為 trueUpdate 您也可以在 DataAdapter 事件內 RowUpdated ,依數據列回應錯誤。 若要繼續更新作業而不在事件內 RowUpdated 產生例外狀況,請將 StatusRowUpdatedEventArgs 屬性設定為 Continue

另請參閱

適用於

Update(DataTable)

來源:
DbDataAdapter.cs
來源:
DbDataAdapter.cs
來源:
DbDataAdapter.cs

針對指定之 DataTable 中的每個插入、更新或刪除的資料列,執行個別的 INSERT、UPDATE 或 DELETE 陳述式,以更新資料庫中的值。

public:
 int Update(System::Data::DataTable ^ dataTable);
public int Update (System.Data.DataTable dataTable);
override this.Update : System.Data.DataTable -> int
Public Function Update (dataTable As DataTable) As Integer

參數

dataTable
DataTable

用來更新資料來源的 DataTable

傳回

DataTable 中成功更新的資料列數目。

例外狀況

來源資料表無效。

要更新的 DataRow 不存在。

-或-

要更新的 DataTable 不存在。

-或-

要用來做為來源的 DataSet 不存在。

嘗試執行 INSERT、UPDATE 或 DELETE 陳述式會造成沒有資料錄受影響。

範例

下列範例使用衍生類別 OleDbDataAdapter來更新數據源。

public DataTable CreateCmdsAndUpdate(string connectionString,
    string queryString)
{
    using (OleDbConnection connection = new OleDbConnection(connectionString))
    {
        OleDbDataAdapter adapter = new OleDbDataAdapter();
        adapter.SelectCommand = new OleDbCommand(queryString, connection);
        OleDbCommandBuilder builder = new OleDbCommandBuilder(adapter);

        connection.Open();

        DataTable customers = new DataTable();
        adapter.Fill(customers);

        // code to modify data in DataTable here

        adapter.Update(customers);

        return customers;
    }
}
Public Function CreateCmdsAndUpdate(ByVal connectionString As String, _
    ByVal queryString As String) As DataTable

    Using connection As New OleDbConnection(connectionString)
        Dim adapter As New OleDbDataAdapter()
        adapter.SelectCommand = New OleDbCommand(queryString, connection)
        Dim builder As New OleDbCommandBuilder(adapter)

        connection.Open()

        Dim customers As New DataTable()
        adapter.Fill(customers)

        ' Code to modify data in DataTable here 

        adapter.Update(customers)
        Return customers
    End Using
End Function

備註

當應用程式呼叫 方法時 Update ,會 DbDataAdapter 檢查 RowState 屬性,並根據 中所 DataSet設定的索引順序,反覆執行每個數據列所需的 INSERT、UPDATE 或 DELETE 語句。 例如, Update 可能會執行 DELETE 語句,後面接著 INSERT 語句,然後執行另一個 DELETE 語句,因為 中數據列 DataTable的順序。

請注意,這些語句不會以批處理方式執行;每個數據列會個別更新。 應用程式可以在您必須控制語句類型的序列 (的情況下呼叫 GetChanges 方法,例如,UPDATEEs) 之前的 INSERT。 如需詳細資訊,請參閱使用 DataAdapters 更新資料來源

如果未指定 INSERT、UPDATE 或 DELETE 語句,方法 Update 會產生例外狀況。 不過,如果您設定 SelectCommand .NET Framework 數據提供者的 屬性,您可以建立 SqlCommandBuilderOleDbCommandBuilder 對象來自動產生單一數據表更新的 SQL 語句。 然後,您未設定的任何其他 SQL 語句都會由 CommandBuilder 產生。 此產生邏輯需要在 中 DataSet提供索引鍵數據行資訊。 如需詳細資訊,請參閱 使用 CommandBuilders 產生命令

方法 Update 會先從第一個對應中列出的數據表擷取數據列,然後再執行更新。 Update然後使用 屬性的值UpdatedRowSource重新整理數據列。 會忽略傳回的任何其他數據列。

將任何數據載入回 DataSet之後, OnRowUpdated 就會引發 事件,讓使用者檢查協調 DataSet 的數據列和命令傳回的任何輸出參數。 成功更新數據列之後,就會接受該數據列的變更。

使用 Update時,執行順序如下所示:

  1. 中的 DataRow 值會移至參數值。

  2. 便會引發 OnRowUpdating 事件。

  3. 命令會執行。

  4. 如果命令設定為 FirstReturnedRecord,則會將 DataRow第一個傳回的結果放在 中。

  5. 如果有輸出參數,它們會放在 中 DataRow

  6. 便會引發 OnRowUpdated 事件。

  7. 呼叫 AcceptChanges

與相關聯的 DbDataAdapter 每個命令通常會有與其相關聯的參數集合。 參數會透過 SourceColumn .NET Framework 數據提供者類別Parameter的 和 SourceVersion 屬性,對應至目前的數據列。 SourceColumnDataTableDbDataAdapter是指參考以取得目前數據列之參數值的數據行。

SourceColumn 是指套用任何數據表對應之前未對應的數據行名稱。 如果 SourceColumn 參考不存在的數據行,所採取的動作取決於下列 MissingMappingAction 其中一個值。

列舉值 已採取的動作
MissingMappingAction.Passthrough 如果沒有對應,請使用 中的 DataSet 源數據行名稱和數據表名稱。
MissingMappingAction.Ignore 產生。SystemException 明確設定對應時,輸入參數遺漏的對應通常是錯誤的結果。
MissingMappingAction.Error 產生。SystemException

屬性 SourceColumn 也可用來將輸出或輸入/輸出參數的值對應回 DataSet。 如果例外狀況參考不存在的數據行,就會產生例外狀況。

SourceVersion.NET Framework 資料提供者類別的 Parameter 屬性會決定要使用數據行值的原始、目前或建議版本。 這項功能通常用來在 UPDATE 語句的 WHERE 子句中包含原始值,以檢查開放式並行存取違規。

注意

如果在更新數據列時發生錯誤,則會擲回例外狀況,並停止執行更新。 若要在發生錯誤時繼續更新作業而不產生例外狀況,請在呼叫 之前將 ContinueUpdateOnError 屬性設定為 trueUpdate 您也可以在 DataAdapter 事件內 RowUpdated ,依數據列回應錯誤。 若要繼續更新作業而不在事件內 RowUpdated 產生例外狀況,請將 StatusRowUpdatedEventArgs 屬性設定為 Continue

另請參閱

適用於

Update(DataSet)

來源:
DbDataAdapter.cs
來源:
DbDataAdapter.cs
來源:
DbDataAdapter.cs

針對指定之 DataSet 中的每個插入、更新或刪除的資料列,執行個別的 INSERT、UPDATE 或 DELETE 陳述式,以更新資料庫中的值。

public:
 override int Update(System::Data::DataSet ^ dataSet);
public override int Update (System.Data.DataSet dataSet);
override this.Update : System.Data.DataSet -> int
Public Overrides Function Update (dataSet As DataSet) As Integer

參數

dataSet
DataSet

用來更新資料來源的 DataSet

傳回

DataSet 中成功更新的資料列數目。

實作

例外狀況

來源資料表無效。

嘗試執行 INSERT、UPDATE 或 DELETE 陳述式會造成沒有資料錄受影響。

範例

下列範例使用衍生類別 OleDbDataAdapter來更新數據源。

public DataSet CreateCmdsAndUpdate(string connectionString,
    string queryString)
{
    using (OleDbConnection connection = new OleDbConnection(connectionString))
    {
        OleDbDataAdapter adapter = new OleDbDataAdapter();
        adapter.SelectCommand = new OleDbCommand(queryString, connection);
        OleDbCommandBuilder builder = new OleDbCommandBuilder(adapter);

        connection.Open();

        DataSet customers = new DataSet();
        adapter.Fill(customers);

        //code to modify data in dataset here

        adapter.Update(customers);

        return customers;
    }
}
Public Function CreateCmdsAndUpdate(ByVal connectionString As String, _
    ByVal queryString As String) As DataSet

    Using connection As New OleDbConnection(connectionString)
        Dim adapter As New OleDbDataAdapter()
        adapter.SelectCommand = New OleDbCommand(queryString, connection)
        Dim builder As New OleDbCommandBuilder(adapter)

        connection.Open()

        Dim customers As New DataSet()
        adapter.Fill(customers)

        ' Code to modify data in DataSet here 

        adapter.Update(customers)

        Return customers
    End Using
End Function

備註

當應用程式呼叫 方法時 Update ,會 DbDataAdapter 檢查 RowState 屬性,並根據 中所 DataSet設定的索引順序,反覆執行每個數據列所需的 INSERT、UPDATE 或 DELETE 語句。 例如, Update 可能會執行 DELETE 語句,後面接著 INSERT 語句,然後執行另一個 DELETE 語句,因為 中數據列 DataTable的順序。

請注意,這些語句不會以批處理方式執行;每個數據列會個別更新。 應用程式可以在您必須控制語句類型的序列 (的情況下呼叫 GetChanges 方法,例如,UPDATEEs) 之前的 INSERT。 如需詳細資訊,請參閱使用 DataAdapters 更新資料來源

如果未指定 INSERT、UPDATE 或 DELETE 語句,方法 Update 會產生例外狀況。 不過,如果您設定 SelectCommand .NET Framework 數據提供者的 屬性,您可以建立 SqlCommandBuilderOleDbCommandBuilder 對象來自動產生單一數據表更新的 SQL 語句。 然後,您未設定的任何其他 SQL 語句都會由 CommandBuilder 產生。 此產生邏輯需要在 中 DataSet提供索引鍵數據行資訊。 如需詳細資訊,請參閱 使用 CommandBuilders 產生命令

方法 Update 會先從第一個對應中列出的數據表擷取數據列,然後再執行更新。 Update然後使用 屬性的值UpdatedRowSource重新整理數據列。 會忽略傳回的任何其他數據列。

將任何數據載入回 DataSet之後, OnRowUpdated 就會引發 事件,讓使用者檢查協調 DataSet 的數據列和命令傳回的任何輸出參數。 成功更新數據列之後,就會接受該數據列的變更。

使用 Update時,執行順序如下所示:

  1. 中的 DataRow 值會移至參數值。

  2. 便會引發 OnRowUpdating 事件。

  3. 命令會執行。

  4. 如果命令設定為 FirstReturnedRecord,則會將 DataRow第一個傳回的結果放在 中。

  5. 如果有輸出參數,它們會放在 中 DataRow

  6. 便會引發 OnRowUpdated 事件。

  7. 呼叫 AcceptChanges

與相關聯的 DbDataAdapter 每個命令通常會有與其相關聯的參數集合。 參數會透過 SourceColumn .NET Framework 數據提供者類別Parameter的 和 SourceVersion 屬性,對應至目前的數據列。 SourceColumnDataTableDbDataAdapter是指參考以取得目前數據列之參數值的數據行。

SourceColumn 是指套用任何數據表對應之前未對應的數據行名稱。 如果 SourceColumn 參考不存在的數據行,所採取的動作取決於下列 MissingMappingAction 其中一個值。

列舉值 已採取的動作
MissingMappingAction.Passthrough 如果沒有對應,請使用 中的 DataSet 源數據行名稱和數據表名稱。
MissingMappingAction.Ignore 產生。SystemException 明確設定對應時,輸入參數遺漏的對應通常是錯誤的結果。
MissingMappingAction.Error 產生。SystemException

屬性 SourceColumn 也可用來將輸出或輸入/輸出參數的值對應回 DataSet。 如果例外狀況參考不存在的數據行,就會產生例外狀況。

SourceVersion.NET Framework 資料提供者類別的 Parameter 屬性會決定要使用數據行值的原始、目前或建議版本。 這項功能通常用來在 UPDATE 語句的 WHERE 子句中包含原始值,以檢查開放式並行存取違規。

注意

如果在更新數據列時發生錯誤,則會擲回例外狀況,並停止執行更新。 若要在發生錯誤時繼續更新作業而不產生例外狀況,請在呼叫 之前將 ContinueUpdateOnError 屬性設定為 trueUpdate 您也可以在 DataAdapter 事件內 RowUpdated ,依數據列回應錯誤。 若要繼續更新作業而不在事件內 RowUpdated 產生例外狀況,請將 StatusRowUpdatedEventArgs 屬性設定為 Continue

另請參閱

適用於

Update(DataRow[])

來源:
DbDataAdapter.cs
來源:
DbDataAdapter.cs
來源:
DbDataAdapter.cs

針對 DataSet 的指定陣列中每個插入、更新或刪除的資料列,執行個別的 INSERT、UPDATE 或 DELETE 陳述式,以更新資料庫中的值。

public:
 int Update(cli::array <System::Data::DataRow ^> ^ dataRows);
public int Update (System.Data.DataRow[] dataRows);
override this.Update : System.Data.DataRow[] -> int
Public Function Update (dataRows As DataRow()) As Integer

參數

dataRows
DataRow[]

用來更新資料來源的 DataRow 物件陣列。

傳回

DataSet 中成功更新的資料列數目。

例外狀況

來源資料表無效。

要更新的 DataRow 不存在。

-或-

要更新的 DataTable 不存在。

-或-

要用來做為來源的 DataSet 不存在。

嘗試執行 INSERT、UPDATE 或 DELETE 陳述式會造成沒有資料錄受影響。

範例

下列範例使用衍生類別 OleDbDataAdapter來更新數據源。

public DataSet CreateCmdsAndUpdate(string connectionString,
    string queryString)
{
    using (OleDbConnection connection = new OleDbConnection(connectionString))
    {
        OleDbDataAdapter adapter = new OleDbDataAdapter();
        adapter.SelectCommand = new OleDbCommand(queryString, connection);
        OleDbCommandBuilder builder = new OleDbCommandBuilder(adapter);

        connection.Open();

        DataSet customers = new DataSet();
        adapter.Fill(customers);

        //code to modify data in dataset here

        //Insert new records from DataSet
        DataRow[] rows = customers.Tables[0].Select(
            null, null, DataViewRowState.Added);
        adapter.Update(rows);

        return customers;
    }
}
Public Function CreateCmdsAndUpdate(ByVal connectionString As String, _
    ByVal queryString As String) As DataSet

    Using connection As New OleDbConnection(connectionString)
        Dim adapter As New OleDbDataAdapter()
        adapter.SelectCommand = New OleDbCommand(queryString, connection)
        Dim builder As New OleDbCommandBuilder(adapter)

        connection.Open()

        Dim customers As New DataSet()
        adapter.Fill(customers)

        ' Code to modify data in DataSet here 

        ' Insert new records from DataSet
        Dim rows() As DataRow = customers.Tables(0).Select( _
            Nothing, Nothing, DataViewRowState.Added)
        adapter.Update(rows)

        Return customers
    End Using
End Function

備註

當應用程式呼叫 方法時 Update ,會 DbDataAdapter 檢查 RowState 屬性,並根據 中所 DataSet設定的索引順序,反覆執行每個數據列所需的 INSERT、UPDATE 或 DELETE 語句。 例如, Update 可能會執行 DELETE 語句,後面接著 INSERT 語句,然後執行另一個 DELETE 語句,因為 中數據列 DataTable的順序。

請注意,這些語句不會以批處理方式執行;每個數據列會個別更新。 應用程式可以在您必須控制語句類型的序列 (的情況下呼叫 GetChanges 方法,例如,UPDATEEs) 之前的 INSERT。 如需詳細資訊,請參閱使用 DataAdapters 更新資料來源

如果未指定 INSERT、UPDATE 或 DELETE 語句,方法 Update 會產生例外狀況。 不過,如果您設定 SelectCommand .NET Framework 數據提供者的 屬性,您可以建立 SqlCommandBuilderOleDbCommandBuilder 對象來自動產生單一數據表更新的 SQL 語句。 然後,您未設定的任何其他 SQL 語句都會由 CommandBuilder 產生。 此產生邏輯需要在 中 DataSet提供索引鍵數據行資訊。 如需詳細資訊,請參閱 使用 CommandBuilders 產生命令

方法 Update 會先從第一個對應中列出的數據表擷取數據列,然後再執行更新。 Update然後使用 屬性的值UpdatedRowSource重新整理數據列。 會忽略傳回的任何其他數據列。

將任何數據載入回 DataSet之後, OnRowUpdated 就會引發 事件,讓使用者檢查協調 DataSet 的數據列和命令傳回的任何輸出參數。 成功更新數據列之後,就會接受該數據列的變更。

使用 Update時,執行順序如下所示:

  1. 中的 DataRow 值會移至參數值。

  2. 便會引發 OnRowUpdating 事件。

  3. 命令會執行。

  4. 如果命令設定為 FirstReturnedRecord,則會將 DataRow第一個傳回的結果放在 中。

  5. 如果有輸出參數,它們會放在 中 DataRow

  6. 便會引發 OnRowUpdated 事件。

  7. 呼叫 AcceptChanges

與相關聯的 DbDataAdapter 每個命令通常會有與其相關聯的參數集合。 參數會透過 SourceColumn .NET Framework 數據提供者類別Parameter的 和 SourceVersion 屬性,對應至目前的數據列。 SourceColumnDataTableDbDataAdapter是指參考以取得目前數據列之參數值的數據行。

SourceColumn 是指套用任何數據表對應之前未對應的數據行名稱。 如果 SourceColumn 參考不存在的數據行,所採取的動作取決於下列 MissingMappingAction 其中一個值。

列舉值 已採取的動作
MissingMappingAction.Passthrough 如果沒有對應,請使用 中的 DataSet 源數據行名稱和數據表名稱。
MissingMappingAction.Ignore 產生。SystemException 明確設定對應時,輸入參數遺漏的對應通常是錯誤的結果。
MissingMappingAction.Error 產生。SystemException

屬性 SourceColumn 也可用來將輸出或輸入/輸出參數的值對應回 DataSet。 如果例外狀況參考不存在的數據行,就會產生例外狀況。

SourceVersion.NET Framework 資料提供者類別的 Parameter 屬性會決定要使用數據行值的原始、目前或建議版本。 這項功能通常用來在 UPDATE 語句的 WHERE 子句中包含原始值,以檢查開放式並行存取違規。

注意

如果在更新數據列時發生錯誤,則會擲回例外狀況,並停止執行更新。 若要在發生錯誤時繼續更新作業而不產生例外狀況,請在呼叫 之前將 ContinueUpdateOnError 屬性設定為 trueUpdate 您也可以在 DataAdapter 事件內 RowUpdated ,依數據列回應錯誤。 若要繼續更新作業而不在事件內 RowUpdated 產生例外狀況,請將 StatusRowUpdatedEventArgs 屬性設定為 Continue

另請參閱

適用於