DB2ResultSet.GetBytes 方法
將位元組串流從指定的直欄偏移讀取至緩衝區作為陣列,從給定的緩衝區偏移開始。
- 名稱空間:
IBM.Data.DB2- 組件:
IBM.Data.DB2(在IBM.Data.DB2.dll中)
語法
idataIndexbufferbufferIndexlengthidataIndexbufferbufferIndexlengthidataIndexbufferbufferIndexlengthidataIndexbufferbufferIndexlength
[Visual Basic]
Public Function GetBytes( _
ByVal As Integer, _
ByVal As Long, _
ByVal () As Byte, _
ByVal As Integer, _
ByVal As Integer _
) As Long
[C#]
public long GetBytes(
int ,
long ,
byte[] ,
int ,
int
);
[C++]
public: __int64 GetBytes(
int ,
__int64 ,
unsigned char __gc[],
int ,
int
);
[JScript]
public function GetBytes(
: int,
: long,
: Byte[],
: int,
: int
) : long;
參數
- i
- 從零開始的直欄序數。
- dataIndex
- 要開始讀取作業之欄位內的索引。
- buffer
- 在其中讀取位元組串流的緩衝區。
- bufferIndex
- buffer 將在其中開始寫入作業的索引。
- length
- 要讀取的位元組數。
回覆值
實際讀取的位元組數。
異常狀況
| 異常狀況類型 | 條件 |
|---|---|
| DB2Exception | 無效的轉換。 |
備註
GetBytes 會傳回欄位中可用的位元組數。 在大部分情況下,這是欄位的確切長度。 不過,如果已使用 GetBytes 從欄位取得位元組,則傳回的數字可能小於欄位的真實長度。 例如,如果 DB2®DataReader 將 BLOB 讀取到緩衝區中,則可能是這種情況。 如需相關資訊,請參閱 Microsoft ® .NET Framework SDK 文件中 System.Data.CommandBehavior 的 SequentialAccess 設定。
如果您傳遞的緩衝區是空值, GetBytes 會傳回欄位的長度 (以位元組為單位)。
不執行任何轉換。 要擷取的資料必須是下列其中一種類型:
- DB2Type.Xml
- DB2類型. 二進位
- DB2Type.VarBinary
- DB2Type.LongVarBinary
- DB2Type.Blob
下表說明傳回物件資料類型與資料伺服器資料類型之間的對映。
| DB2類型資料類型 | Db2® 資料類型 | Informix® 資料類型 |
|---|---|---|
| XML | XML | |
| 二進位 | BINARY , CHAR for BIT 資料 | |
| VARBINARY | VARBINARY | |
| LongVarBinary | LONG VARCHAR FOR BIT DATA | |
| 二進位大型物件 | BLOB | BLOB , BYTE |