SqlDataReader.GetSqlValues(Object[]) 方法

定義

命名空間:

Microsoft.Data.SqlClient

組件:

Microsoft.Data.SqlClient.dll

套件:

Microsoft.Data.SqlClient v5.2.0

填滿 Object 陣列，其中包含記錄內所有資料行 (表示為 SQL Server 型別) 的值。

public:
 virtual int GetSqlValues(cli::array <System::Object ^> ^ values);

public virtual int GetSqlValues (object[] values);

abstract member GetSqlValues : obj[] -> int
override this.GetSqlValues : obj[] -> int

Public Overridable Function GetSqlValues (values As Object()) As Integer

參數

values

Object[]

要將值複製到其中的目標 Object 陣列。 資料行的值都會以 SQL Server 型別來表示。

傳回

Int32

整數，表示已複製的資料行數目。

例外狀況

ArgumentNullException

values 為 null。

備註

使用 SQL 類型系統，而不是 CLR 類型系統，傳回單一呼叫中記錄中所有資料行的值。 陣列的 Object 長度不需要符合記錄中的資料行數目。 您可以傳遞 Object 包含少於記錄中所含資料行數目的陣列。 陣列保留的資料 Object 量只會複製到陣列，從序數為 0 的資料行開始。 您也可以傳遞 Object 長度超過結果資料列中包含的資料行數目的陣列。 任何剩餘的資料行都未變更。