Freigeben über


SqlBinary.Item-Eigenschaft

Ruft aus der Value-Eigenschaft ein einzelnes Byte ab, das sich an der durch den Ganzzahlparameter index angegebenen Position befindet. Wenn index eine Position hinter dem Ende des Bytearrays angibt, wird eine SqlNullValueException ausgelöst. Diese Eigenschaft ist schreibgeschützt.

Namespace: System.Data.SqlTypes
Assembly: System.Data (in system.data.dll)

Syntax

'Declaration
Public ReadOnly Default Property Item ( _
    index As Integer _
) As Byte
'Usage
Dim instance As SqlBinary
Dim index As Integer
Dim value As Byte

value = instance(index)
public byte this [
    int index
] { get; }
public:
property unsigned char default [int] {
    unsigned char get (int index);
}
/** @property */
public byte get_Item (int index)
JScript unterstützt die Verwendung von indizierten Eigenschaften, aber nicht die Deklaration von neuen indizierten Eigenschaften.

Parameter

  • index
    Die Position des abzurufenden Bytes.

Eigenschaftenwert

Das Byte, das sich an der durch den ganzzahligen Parameter angegebenen Position befindet.

Ausnahmen

Ausnahmetyp Bedingung

SqlNullValueException

Die Eigenschaft wird gelesen, wenn die Value-Eigenschaft Null enthält.

– oder –

Der index-Parameter gibt eine Position an, die sich außerhalb der durch die Length-Eigenschaft angegebenen Länge des Bytearrays befindet.

Hinweise

Damit keine SqlNullValueException ausgelöst wird, prüfen Sie immer die IsNull-Eigenschaft und die Length-Eigenschaft, bevor Sie diese Eigenschaft lesen.

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

SqlBinary-Struktur
SqlBinary-Member
System.Data.SqlTypes-Namespace

Weitere Ressourcen

Arbeiten mit SqlTypes