SqlDataRecord.GetBytes(Int32, Int64, Byte[], Int32, Int32) Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Obtient la valeur de la colonne spécifiée par l’ordinal en tant que tableau d’objets Byte.
public:
virtual long GetBytes(int ordinal, long fieldOffset, cli::array <System::Byte> ^ buffer, int bufferOffset, int length);public virtual long GetBytes (int ordinal, long fieldOffset, byte[] buffer, int bufferOffset, int length);abstract member GetBytes : int * int64 * byte[] * int * int -> int64
override this.GetBytes : int * int64 * byte[] * int * int -> int64Public Overridable Function GetBytes (ordinal As Integer, fieldOffset As Long, buffer As Byte(), bufferOffset As Integer, length As Integer) As LongParamètres
- ordinal
- Int32
Numéro en base zéro de la colonne.
- fieldOffset
- Int64
Offset dans la valeur de champ qui détermine où commencer la récupération des octets.
- buffer
- Byte[]
Mémoire tampon cible dans laquelle copier les octets.
- bufferOffset
- Int32
Offset dans la mémoire tampon qui détermine où commencer la copie des octets.
- length
- Int32
Nombre d’octets à copier dans la mémoire tampon.
Retours
Nombre d'octets copiés.
Implémente
Exceptions
ordinal est inférieur à 0 ou supérieur au nombre de colonnes (soit FieldCount).
La colonne spécifiée par ordinal est Null.
Il existe une incompatibilité de type.
Remarques
Cette méthode vous permet d’obtenir une valeur binaire en un seul appel ou en segments. L’obtention de la valeur en blocs est utile pour les valeurs volumineuses ou de taille inconnue.
Pour obtenir la valeur en plusieurs segments, allouez un tableau d’octets de la taille de segment et appelez GetBytes à plusieurs reprises, en ajustant le fieldOffset paramètre en conséquence dans chaque appel.