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.CommandBehaviorSequentialAccess 設定。

如果您傳遞的緩衝區是空值, 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