Méthode SqlCeDataReader.GetBytes
Lit un flux d'octets à partir de l'offset de colonne spécifié dans la mémoire tampon sous la forme d'un tableau commençant à l'offset de mémoire tampon donné.
Espace de noms : System.Data.SqlServerCe
Assembly : System.Data.SqlServerCe (en System.Data.SqlServerCe.dll)
Syntaxe
'Déclaration
<SecurityTreatAsSafeAttribute> _
<SecurityCriticalAttribute> _
Public Overrides Function GetBytes ( _
ordinal As Integer, _
dataIndex As Long, _
buffer As Byte(), _
bufferIndex As Integer, _
length As Integer _
) As Long
'Utilisation
Dim instance As SqlCeDataReader
Dim ordinal As Integer
Dim dataIndex As Long
Dim buffer As Byte()
Dim bufferIndex As Integer
Dim length As Integer
Dim returnValue As Long
returnValue = instance.GetBytes(ordinal, _
dataIndex, buffer, bufferIndex, length)
[SecurityTreatAsSafeAttribute]
[SecurityCriticalAttribute]
public override long GetBytes(
int ordinal,
long dataIndex,
byte[] buffer,
int bufferIndex,
int length
)
[SecurityTreatAsSafeAttribute]
[SecurityCriticalAttribute]
public:
virtual long long GetBytes(
int ordinal,
long long dataIndex,
array<unsigned char>^ buffer,
int bufferIndex,
int length
) override
[<SecurityTreatAsSafeAttribute>]
[<SecurityCriticalAttribute>]
abstract GetBytes :
ordinal:int *
dataIndex:int64 *
buffer:byte[] *
bufferIndex:int *
length:int -> int64
[<SecurityTreatAsSafeAttribute>]
[<SecurityCriticalAttribute>]
override GetBytes :
ordinal:int *
dataIndex:int64 *
buffer:byte[] *
bufferIndex:int *
length:int -> int64
public override function GetBytes(
ordinal : int,
dataIndex : long,
buffer : byte[],
bufferIndex : int,
length : int
) : long
Paramètres
- ordinal
Type : System.Int32
Ordinal de colonne de base zéro.
- dataIndex
Type : System.Int64
Index du champ auquel commencer l'opération de lecture.
- buffer
Type : array<System.Byte[]
Mémoire tampon dans laquelle lire le flux d'octets.
- bufferIndex
Type : System.Int32
Index de buffer auquel commencer l'opération de lecture.
- length
Type : System.Int32
Longueur maximale à copier dans la mémoire tampon.
Valeur de retour
Type : System.Int64
Nombre réel d'octets lus.
Implémente
IDataRecord.GetBytes(Int32, Int64, array<Byte[], Int32, Int32)
Exceptions
| Exception | Condition |
|---|---|
| InvalidOperationException | L'opération n'est pas valide. Le SqlCeDataReader peut être placé après la dernière ligne dans le jeu de résultats. |
Notes
GetBytes retourne le nombre d'octets disponibles dans le champ. Dans la plupart des cas, il s'agit de la longueur exacte du champ. Le nombre retourné risque toutefois d'être inférieur à la longueur réelle du champ si GetBytes a déjà été utilisé pour obtenir des octets à partir du champ. Cela peut être le cas, par exemple, si SqlCeDataReader lit une structure de données volumineuse dans une mémoire tampon. Pour plus d'informations, consultez le paramètre SequentialAccess de CommandBehavior.
Si vous passez une mémoire tampon ayant la valeur nullune référence Null (Nothing dans Visual Basic), GetBytes retourne la longueur du champ en octets.
Aucune conversion n'est effectuée. Par conséquent, les données récupérées doivent déjà être un tableau d'octets.