La propriété ActualSize renvoie la longueur réelle de la valeur d'un champ.

Long

La propriété ActualSize renvoie une valeur indiquant le nombre d'octets stockés dans le champ spécifié, par opposition au nombre maximal d'octets autorisés (indiqués par la propriété DefinedSize). Si l'objet ADO ne peut pas déterminer la longueur de la valeur de l'objet Field, la valeur adUnknown est renvoyée.

Propriété Field.DefinedSize

La méthode AppendChunk est utilisée pour ajouter des données à un grand champ de données ou binaire.

Data (Variant)

Contient la grande quantité de données à ajouter à l'objet Field actuel.

La méthode AppendChunk ajoute de grandes quantités de données (de type texte ou binaire) à un objet Field existant. Elle peut s'avérer très pratique si le système actuel possède une quantité de mémoire limitée par rapport à la quantité requise pour l'exécution de l'opération. En employant la méthode AppendChunk, vous pouvez ajouter les données à votre objet Field par incréments, selon la manière qui vous convient le mieux.

Vous pouvez utiliser la méthode AppendChunk avec un objet Field uniquement si le bit adFldLong de la propriété Arguments de cet objet Field est défini sur True.

En appelant la méthode AppendChunk pour la première fois, vous écrasez les données pouvant être présentes dans ce champ. A chaque nouvel appel à la méthode AppendChunk, vous ajoutez les données à celles qui figurent déjà dans l'objet. L'objet ADO suppose que vous avez terminé d'ajouter des données à un champ particulier dans un jeu d'enregistrements si vous passez à la lecture ou l'écriture des données dans un autre champ du même jeu d'enregistrements. Cela signifie que si vous appelez de nouveau la méthode AppendChunk sur le champ original, les données sont de nouveau effacées, comme s'il s'agissait du premier appel à la méthode. Cela ne se produit pas lors de la lecture ou de l'écriture de données dans un autre objet Recordset, sauf s'il s'agit d'un clone de l'objet Recordset original.

Propriété Field.Attributes, Enumération FieldAttributeEnum

La propriété Attributes définit ou renvoie des caractéristiques spécifiques à l'objet Field.

Long

La propriété Attributes est définie sur lecture seule ; sa valeur peut être une somme des valeurs de l'énumération FieldAttributesEnum répertoriées à l'annexe E et indiquant les caractéristiques de l'objet Field, par exemple si ce dernier peut être mis à jour ou s'il représente un identificateur de ligne.

Enumération FieldAttributesEnum

La propriété DataFormat lie l'objet Field en cours à une commande liée aux données.

StdDataFormat

La propriété DataFormat est en lecture/écriture. Elle accepte et renvoie un objet StdDataFormat utilisé pour ajouter un objet lié.

La propriété DefinedSize représente la capacité en octets du type de données d'un objet Field.

Long

La propriété DefinedSize est utilisée pour déterminer, en octets, la capacité des données de la propriété Value de l'objet Field. Elle diffère de la propriété ActualSize qui indique le nombre d'octets de la taille définie pour le type de données sont en cours d'utilisation.

Propriété Field.ActualSize

La méthode GetChunk renvoie le nombre spécifié d'octets ou de caractères du champ spécifié.

NumBytes

Le paramètre NumBytes est une valeur Long représentant le nombre d'octets ou de caractères que vous voulez recevoir.

Variant

La méthode GetChunk obtient des informations d'un objet Field appartenant à une collection Fields d'un objet Recordset ouvert. Si la propriété Arguments de l'objet Field est définie sur adFldLong, vous pouvez utiliser la méthode GetChunk dans ce champ.

Le premier appel à GetChunk extrait le nombre d'octets spécifiés dans l'appel de la méthode, depuis le début du champ. Les appels suivants à GetChunk renvoient des données commençant là où le dernier appel à GetChunk s'est arrêté. Si la quantité d'octets ou de caractères dans l'objet Field est inférieure à la quantité requise, uniquement le reste est renvoyé sans remplissage pour la différence.

Lorsque vous lisez ou écrivez dans un autre champ au sein du même objet Recordset (un objet qui n'est pas un clone de ce jeu d'enregistrements), l'objet ADO suppose que vous avez terminé la récupération des morceaux de cet objet Field particulier. L'appel suivant à GetChunk s'exécute comme s'il s'agissait du premier appel, récupérant le premier nombre d'octets ou de caractères que vous demandez.

Propriété Field.Arguments

La propriété Name définit le nom de l'objet Field actuel.

String

La propriété Name extrait un objet Field de la collection Fields. Les noms ne doivent pas être uniques dans les collections.

La propriété NumericScale indique l'échelle de valeurs numériques dans l'objet Field actuel.

Byte

La propriété NumericScale en lecture seule identifie le nombre d'octets utilisés à droite de la décimale pour un objet Field contenant une valeur numérique.

La propriété OriginalValue renvoie la valeur qui appartenait à un champ avant l'apport de modifications.

Variant

En mode Immédiat, la propriété OriginalValue renvoie la valeur d'un champ dans l'enregistrement en cours avant l'apport de modifications. En d'autres termes, la propriété OriginalValue représente la valeur du champ au moment de l'appel de la dernière méthode Update. C'est cette valeur qui est remplacée dans l'objet Field lorsque la méthode CancelUpdate est appelée.

En mode de mise à jour par lots, la propriété OriginalValue renvoie la valeur d'un champ dans l'enregistrement en cours avant l'apport des modifications. En d'autres termes, la propriété OriginalValue représente la valeur du champ au moment de l'appel à la dernière méthode UpdateBatch. C'est cette valeur qui est remplacée dans l'objet Field lorsque la méthode CancelBatch est appelée.

Méthode Recordset.CancelBatch, Méthode Recordset.CancelUpdate, Méthode Recordset.Update, Méthode Recordset.UpdateBatch

La propriété Precision représente le degré de précision d'une valeur numérique dans l'objet Field actuel.

Byte

La propriété Precision est en lecture seule pour l'objet Field. Cette propriété renvoie une valeur Byte indiquant le nombre total de chiffres utilisés pour représenter une valeur pour un objet Field numérique.

La collection Properties contient des caractéristiques spécifiques à l'objet Field destinées au fournisseur de données en cours.

Properties (objet Collection)

La classe de collection Properties contient une instance de classe Property pour chaque propriété spécifique à l'objet Field pour le fournisseur de données.

La propriété Status indique l'état de l'objet Field actuel.

FieldStatusEnum

La valeur par défaut de la propriété Status est adFieldOK.

Après un appel à la méthode Update de l'objet Record ou Recordset, si une erreur est survenue, la propriété Status de chaque objet Field est définie sur une valeur de l'énumération FieldStatusEnum, décrivant le problème.

Si vous ajoutez des objets Field à la collection Fields ou en supprimez, la propriété Status peut vous indiquer si ces objets ont été ajoutés ou supprimés correctement.

La propriété Status peut contenir plusieurs valeurs d'énumération FieldStatusEnum à la fois.

Enumération FieldStatusEnum, Méthode Record.Update, Méthode Recordset.Update

La propriété Type indique le type de données de la propriété Value de l'objet Field.

DataTypeEnum

La propriété Type est en lecture seule, sauf si elle s'applique à un nouvel objet Field qui a été ajouté à la collection Fields d'un objet Record. Même dans ce cas, elle n'est en lecture/écriture que si la propriété Value de l'objet Field a déjà été spécifiée et si le fournisseur de données a ajouté un objet Field à la source des données (à l'aide de la méthode Update de la collection Fields).

Enumération DataTypeEnum, Propriété Field.Value, Méthode Fields.Update

La propriété UnderlyingValue renvoie la valeur actuelle de la propriété Value de l'objet Field.

Variant

La propriété UnderlyingValue renvoie la valeur (de l'enregistrement en cours) de l'objet Field associé. Cette valeur peut différer de la propriété OriginalValue, car elle indique la valeur d'un champ pour la transaction en cours.

Cette valeur est la même que celle utilisée par la méthode Resync pour remplacer la valeur de la propriété Value.

Propriété Field.OriginalValue, Propriété Field.Value, Méthode Recordset.Resync

La propriété Value indique la valeur affectée à l'objet Field actuel.

Variant

La propriété Value est utilisée pour lire et définir la valeur de l'objet Field associé. La propriété Value prend en charge les données binaires longues via l'objet  ADO.

Voir l'objet Field pour plus d'informations et des exemples en rapport avec la collection Fields.

Recordset

Offre une vue spécifique d'un groupe d'enregistrements de la connexion associée.

Field

Contient des informations sur un champ unique dans l'enregistrement en cours d'un objet Recordset ouvert.

Append

Ajoute un nouvel objet Field à la collection.

CancelUpdate

Annule toute modification en attente aux objets Field individuels de la collection Fields de l'objet Record.

Delete

Supprime un objet Field de la collection Fields en cours.

Refresh

D'après la documentation de Microsoft, n'exécute aucune fonction visible.

Resync

Met à jour la collection en cours en tenant compte de la base de données sous-jacente.

Update

Conserve toute modification apportée à la collection Fields en cours d'un objet Record.

Count

Indique le nombre d'objets Field appartenant à la collection Fields associée.

Item

Permet d'accéder à un objet Field spécifique appartenant à la collection Fields.

La méthode Append ajoute un nouvel objet Field à la collection.

Name (String)

Représente le nom du champ à ajouter à la collection Fields. Ce nom ne doit pas déjà exister dans la collection.

Type (DataTypeEnum)

Indique le type de données de la propriété Value de l'objet Field. La valeur de ce paramètre est définie par défaut sur adEmpty.

DefinedSize (String)

Facultatif. Impose la longueur de la valeur stockée dans l'objet Field. La valeur de ce paramètre est dérivée de la propriété Type.

Attrib (FieldAttributeEnum)

Facultatif. Fournit des informations supplémentaires à propos de l'objet Field. La valeur de ce paramètre est définie par défaut sur adFldDefault.

FieldValue (Variant)

Facultatif. Attribue une valeur au nouvel objet Field. La valeur de ce paramètre est définie par défaut sur Null. Ce paramètre est valide uniquement lorsque vous ajoutez un objet Field à une collection Fields de l'objet Record, et non de l'objet Recordset.

Les types de données suivants ne sont pas pris en charge par l'objet ADO et ne peuvent pas être utilisés lorsque vous ajoutez de nouveaux objets Field à la classe de collection : adIDispatch, adIUnknown et adVariant.

Vous ne pouvez pas ajouter les types de données suivants à une collection Field. Ils génèrent une erreur. adArray, adChapter, adEmpty, adPropVariant et adUserDefined.

Lorsque vous utilisez la méthode Append avec une collection Fields d'un objet Recordset, vous ne pouvez pas utiliser le paramètre FieldValue. Au lieu de cela, vous devez ajouter les objets Field pendant que l'objet Recordset est fermé, et leur attribuer des valeurs lorsqu'il est ouvert.

Lorsque vous ajoutez des objets Field à une collection Fields d'un objet Record, vous devez d'abord définir la propriété Field.Value et appeler la méthode Update avant d'accéder aux autres propriétés Field, telles que Type.

Enumération DataTypeEnum, Enumération FieldAttributeEnum

La méthode CancelUpdate annule toute modification en attente aux objets Field individuels de la collection Fields de l'objet Record.

Après l'appel à la méthode CancelUpdate, tous les objets Field présentent l'état adFieldOK.

Objet Record

La propriété Count indique le nombre d'objets Field appartenant à la collection Fields associée.

Long

Si la valeur de la propriété Count indique zéro, il n'existe aucun objet Field dans la collection Fields associée. Toutefois, les objets Field appartenant à la collection Fields associée sont indexés de 0 à la valeur de la propriété Count, moins un.

La méthode Delete supprime un objet Field de la collection Fields en cours.

Field

Le nom d'un objet Field valide au sein de la collection Fields en cours ou la position ordinale d'un objet Field au sein de la collection à supprimer.

Vous ne pouvez appeler la méthode Field.Delete que sur un objet Recordset fermé.

La propriété Item permet d'accéder à un objet Field spécifique appartenant à la collection Fields.

Object

L'espace réservé Index représente un type de données Variant équivalent à la position ordinale d'un objet Field au sein de la collection Fields. Si la collection Fields ne contient pas l'élément requis, une erreur est générée.

Certains langages ne prennent pas en charge la propriété Item dans la première syntaxe. Le cas échéant, utilisez la seconde syntaxe, sans le nom de méthode Item.

D'après la documentation de Microsoft, la méthode Refresh n'exécute aucune fonction visible.

Pour mettre à jour la collection Fields avec les modifications de la base de données sous-jacente, utilisez la méthode Resync ou la méthode MoveFirst si l'objet Recordset ne prend pas en charge les signets.

Méthode Recordset.MoveFirst, Méthode Recordset.Resync

La méthode Resync met à jour la collection en cours en tenant compte de la base de données sous-jacente.

ResyncValues (ResyncEnum)

Facultatif. Indique si les valeurs sous-jacentes au sein de la collection Fields sont remplacées. La valeur de ce paramètre est définie par défaut sur adResyncAllValues.

La méthode Resync resynchronise les objets Field d'une collection Fields de l'objet Record avec ceux dans la base de données sous-jacente.

La valeur par défaut pour le seul paramètre de cette méthode, adResyncAllValues, synchronise toutes les valeurs dans les propriétés UnderlyingValue, Value et OriginalValue.

Si un objet Field au sein d'une collection présente une propriété Status égale à adFieldPendingUnknown ou à adFieldPendingInsert, alors la méthode Resync est ignorée au niveau de ces objets Field.

Propriété Field.OriginalValue, Propriété Field.Status, Propriété Field.UnderlyingValue, Propriété Field.Value, Enumération ResyncEnum

La méthode Update conserve toute modification en attente à la collection Fields en cours d'un objet Record.

Dim parameter As ADODB.Parameter