DB2DataReader.GetChars 方法

語法

idataIndexbufferbufferIndexlengthidataIndexbufferbufferIndexlengthidataIndexbufferbufferIndexlengthidataIndexbufferbufferIndexlength
[Visual Basic]
Public Function GetChars( _
   ByVal  As Integer, _
   ByVal  As Long, _
   ByVal () As Char, _
   ByVal  As Integer, _
   ByVal  As Integer _
) As Long
[C#]
public long GetChars(
   int ,
   long ,
   char[] ,
   int ,
   int 
);
[C++]
public: __int64 GetChars(
   int ,
   __int64 ,
   __wchar_t  __gc[],
   int ,
   int 
);
[JScript]
public function GetChars(
    : int,
    : long,
    : Char[],
    : int,
    : int
) : long;

參數

i

從零開始的直欄序數。

dataIndex

要開始讀取作業之列內的索引。

buffer

要將資料複製到其中的緩衝區。

bufferIndex

buffer 將在其中開始寫入作業的索引。

length

要讀取的字元數。

回覆值

實際讀取的字元數。

異常狀況

備註

GetChars 會傳回欄位中可用的字元數。 在大部分情況下，這是欄位的確切長度。 不過，如果已使用 GetChars 來從欄位取得字元，則傳回的數字可能小於欄位的真實長度。 例如，如果 DB2®DataReader 將 CLOB 讀取到緩衝區中，則可能是這種情況。 如需相關資訊，請參閱 Microsoft ® .NET Framework SDK 文件中 System.Data.CommandBehavior 的 SequentialAccess 設定。

如果您傳遞的緩衝區是空值。 GetChars 會傳回欄位的長度 (以字元為單位)。