DataRowExtensions.SetField 方法

定義

命名空間:

System.Data

組件:

System.Data.Common.dll

在 DataRow 中，為指定的資料行設定新的值。

多載

SetField<T>(DataRow, DataColumn, T)	在 DataRow 中，為指定的資料行設定新的值。 SetField<T>(DataRow, DataColumn, T) 方法也支援可為 null 的型別。
SetField<T>(DataRow, Int32, T)	在 DataRow (會針對它呼叫此方法) 中，為指定的資料行設定新的值。 SetField<T>(DataRow, Int32, T) 方法也支援可為 null 的型別。
SetField<T>(DataRow, String, T)	在 DataRow 中，為指定的資料行設定新的值。 SetField<T>(DataRow, String, T) 方法也支援可為 null 的型別。

SetField<T>(DataRow, DataColumn, T)

來源:

DataRowExtensions.cs

在 DataRow 中，為指定的資料行設定新的值。 SetField<T>(DataRow, DataColumn, T) 方法也支援可為 null 的型別。

public:
generic <typename T>
[System::Runtime::CompilerServices::Extension]
 static void SetField(System::Data::DataRow ^ row, System::Data::DataColumn ^ column, T value);

public static void SetField<T> (this System.Data.DataRow row, System.Data.DataColumn column, T? value);

static member SetField : System.Data.DataRow * System.Data.DataColumn * 'T -> unit

<Extension()>
Public Sub SetField(Of T) (row As DataRow, column As DataColumn, value As T)

類型參數

T

泛型參數，會指定資料行的實值型別。

參數

row

DataRow

輸入 DataRow，作用為擴充方法的 this 執行個體。

column

DataColumn

輸入 DataColumn，指定要擷取哪個資料列值。

value

T

指定之資料行的新資料列值，這個值的型別為 T。

例外狀況

ArgumentException

找不到 column 指定的資料行。

ArgumentNullException

column 為 null。

DeletedRowInaccessibleException

嘗試在已刪除的資料列上設定值時發生。

InvalidCastException

基礎資料行的實值型別不能轉換成泛型參數 T 所指定的型別。

備註

如果 value 為 null，方法SetField會將基礎 DataColumn中的 Null 值轉換為 DBNull.Value 。

方法 SetField 不會執行任何類型轉換。 不過，這並不表示不會進行型別轉換。 方法SetField會公開 類別的 ADO.NET 2.0 行為DataRow。 類型轉換可由 物件執行 DataRow ，然後轉換的值會儲存至數據列。

例外狀況可以透過 SetField 基礎 DataRow 物件的方法向上傳遞。

SetField<T>(DataRow, Int32, T)

來源:

DataRowExtensions.cs

在 DataRow (會針對它呼叫此方法) 中，為指定的資料行設定新的值。 SetField<T>(DataRow, Int32, T) 方法也支援可為 null 的型別。

public:
generic <typename T>
[System::Runtime::CompilerServices::Extension]
 static void SetField(System::Data::DataRow ^ row, int columnIndex, T value);

public static void SetField<T> (this System.Data.DataRow row, int columnIndex, T? value);

static member SetField : System.Data.DataRow * int * 'T -> unit

<Extension()>
Public Sub SetField(Of T) (row As DataRow, columnIndex As Integer, value As T)

類型參數

T

泛型參數，會指定資料行的實值型別。

參數

row

DataRow

輸入 DataRow，作用為擴充方法的 this 執行個體。

columnIndex

Int32

要設定其值的資料行之以零起始的序數。

value

T

指定之資料行的新資料列值，這個值的型別為 T。

例外狀況

DeletedRowInaccessibleException

嘗試在已刪除的資料列上設定值時發生。

IndexOutOfRangeException

ordinal 引數超出範圍。

InvalidCastException

基礎資料行的實值型別不能轉換成泛型參數 T 所指定的型別。

備註

如果 value 為 null，方法SetField會將基礎 DataColumn中的 Null 值轉換為 DBNull.Value 。

方法 SetField 不會執行任何類型轉換。 不過，這並不表示不會進行型別轉換。 方法SetField會公開 類別的 ADO.NET 2.0 行為DataRow。 類型轉換可由 物件執行 DataRow ，然後轉換的值會儲存至數據列。

例外狀況可以透過 SetField 基礎 DataRow 物件的方法向上傳遞。

SetField<T>(DataRow, String, T)

來源:

DataRowExtensions.cs

在 DataRow 中，為指定的資料行設定新的值。 SetField<T>(DataRow, String, T) 方法也支援可為 null 的型別。

public:
generic <typename T>
[System::Runtime::CompilerServices::Extension]
 static void SetField(System::Data::DataRow ^ row, System::String ^ columnName, T value);

public static void SetField<T> (this System.Data.DataRow row, string columnName, T? value);

static member SetField : System.Data.DataRow * string * 'T -> unit

<Extension()>
Public Sub SetField(Of T) (row As DataRow, columnName As String, value As T)

類型參數

T

泛型參數，會指定資料行的實值型別。

參數

row

DataRow

輸入 DataRow，作用為擴充方法的 this 執行個體。

columnName

String

要設定其值的資料行名稱。

value

T

指定之資料行的新資料列值，這個值的型別為 T。

例外狀況

ArgumentException

找不到 columnName 指定的資料行。

DeletedRowInaccessibleException

嘗試在已刪除的資料列上設定值時發生。

InvalidCastException

基礎資料行的實值型別不能轉換成泛型參數 T 所指定的型別。

備註

如果 value 為 null，方法SetField會將基礎 DataColumn中的 Null 值轉換為 DBNull.Value 。

方法 SetField 不會執行任何類型轉換。 不過，這並不表示不會進行型別轉換。 方法SetField會公開 類別的 ADO.NET 2.0 行為DataRow。 類型轉換可由 物件執行 DataRow ，然後轉換的值會儲存至數據列。

例外狀況可以透過 SetField 基礎 DataRow 物件的方法向上傳遞。