次の方法で共有

SqlCeDataReader.GetChars メソッド

  • [アーティクル]

メモ : この名前空間、クラス、およびメンバは、.NET Framework Version 1.1 だけでサポートされています。

指定した列オフセットからの文字ストリームを、配列としてバッファに読み込みます。読み込みは、指定したバッファ オフセットから開始されます。

Public Overridable Function GetChars( _
   ByVal ordinal As Integer, _   ByVal dataIndex As Long, _   ByVal buffer() As Char, _   ByVal bufferIndex As Integer, _   ByVal length As Integer _) As Long Implements IDataRecord.GetChars
[C#]
public virtual long GetChars(intordinal,longdataIndex,char[] buffer,intbufferIndex,intlength);
[C++]
public: virtual __int64 GetChars(intordinal,__int64dataIndex,__wchar_tbuffer __gc[],intbufferIndex,intlength);
[JScript]
public function GetChars(
   ordinal : int,dataIndex : long,buffer : Char[],bufferIndex : int,length : int) : long;

パラメータ

  • ordinal
    列の 0 から始まる序数。
  • dataIndex
    読み込みを開始する行内のインデックス。
  • buffer
    データのコピー先のバッファ。
  • bufferIndex
    読み込みを開始する buffer のインデックス。
  • length
    読み込む文字数。

戻り値

実際に読み込まれた文字数。

実装

IDataRecord.GetChars

例外

例外の種類 条件
InvalidOperationException 操作が有効ではありません。 SqlCeDataReader が、結果セットの最後の行よりも後に置かれている可能性があります。

解説

GetChars は、フィールド内で利用可能な文字数を返します。ほとんどの場合、これは正確なフィールド長です。ただし、既に GetChars を使用してフィールドから文字を取得している場合は、返される文字数が、フィールドの実際の長さよりも小さくなることがあります。これは、 SqlCeDataReader が、大きいデータ構造体をバッファに読み込んでいるときなどに起こります。詳細については、 CommandBehavior の SequentialAccess 設定のトピックを参照してください。

null のバッファを渡すと、 GetChars は、文字単位のフィールド長を返します。

変換は実行されません。そのため、取得するデータは文字配列である必要があります。

必要条件

プラットフォーム: .NET Compact Framework - Windows CE .NET

.NET Framework セキュリティ:

参照

SqlCeDataReader クラス | SqlCeDataReader メンバ | System.Data.SqlServerCe 名前空間