整数パラメータ index で指定された位置にある Value プロパティから 1 バイトを取得します。index で示された位置がバイト配列の末尾を超えている場合は、 SqlNullValueException が発生します。このプロパティは読み取り専用です。
[C#] C# では、このプロパティは SqlBinary クラスのインデクサになります。
Public Default ReadOnly Property Item( _
ByVal index As Integer _) As Byte
[C#]
public byte this[intindex] {get;}
[C++]
public: __property unsigned char get_Item(intindex);
[JScript]
returnValue = SqlBinaryObject.Item(index);またはreturnValue = SqlBinaryObject(index);
[JScript] JScript では、この型で定義されている既定のインデックス プロパティを使用することができます。しかし、独自のインデックス プロパティを明示的に定義することはできません。ただし、このクラスの expando 属性を指定すると、既定のインデックス プロパティが提供されます。提供されるインデックス プロパティの型は Object 型であり、インデックス型は String になります。
引数 [JScript]
- index
取得するバイトの位置。
パラメータ [Visual Basic, C#, C++]
- index
取得するバイトの位置。
プロパティ値
整数パラメータで指定された位置にあるバイト。
例外
| 例外の種類 | 条件 |
|---|---|
| SqlNullValueException | Value プロパティに Null が格納されているときに、プロパティが読み取られました。
または index パラメータが示す位置が、 Length プロパティで示されるバイト配列の長さを超えています。 |
解説
SqlNullValueException が発生しないようにするには、このプロパティを読み取る前に必ず IsNull プロパティと Length プロパティを確認します。
必要条件
プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ