SqlCeDataReader.GetOrdinal メソッド
列名を指定して、列の序数を取得します。
名前空間: System.Data.SqlServerCe
アセンブリ: System.Data.SqlServerCe (System.Data.SqlServerCe.dll)
構文
'宣言
Public Overrides Function GetOrdinal ( _
name As String _
) As Integer
'使用
Dim instance As SqlCeDataReader
Dim name As String
Dim returnValue As Integer
returnValue = instance.GetOrdinal(name)
public override int GetOrdinal(
string name
)
public:
virtual int GetOrdinal(
String^ name
) override
abstract GetOrdinal :
name:string -> int
override GetOrdinal :
name:string -> int
public override function GetOrdinal(
name : String
) : int
パラメーター
- name
型: System.String
列の名前。
戻り値
型: System.Int32
列の 0 から始まる序数。
実装
IDataRecord.GetOrdinal(String)
例外
| 例外 | 条件 |
|---|---|
| IndexOutOfRangeException | 指定された名前は有効な列名ではありません。 |
| InvalidOperationException | 操作が有効ではありません。SqlCeDataReader が、結果セットの最後の行よりも後に置かれている可能性があります。 |
説明
GetOrdinal では、最初に、大文字と小文字を区別して検索が実行されます。それに失敗した場合は、大文字と小文字を区別せずに、2 回目の検索が実行されます。
名前を基にした検索よりも、序数を基にした検索の方が効率的です。ループ内では、GetOrdinal を呼び出すのは効率的ではありません。GetOrdinal を 1 回呼び出し、ループ内で使用するために結果を整数の変数に割り当てることによって、時間を節約できます。