Objet Field | (Versions 2.0, 2.1, 2.5 et 2.6)
Dim field As ADODB.Field L'objet Field représente une colonne individuelle dans la collection Fields de l'objet Recordset ou Record. Un objet Field contient des propriétés de métadonnées définissant ses type de données, taille et précision.

Propriété Field.ActualSize | (Versions 2.0, 2.1, 2.5 et 2.6)
actualsize = field.ActualSize
La propriété ActualSize renvoie la longueur réelle de la valeur d'un champ.
Type de données
Long
Description
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.
Voir aussi
Propriété Field.DefinedSize

Field.AppendChunk | (Versions 2.0, 2.1, 2.5 et 2.6)
Données field.AppendChunk
La méthode AppendChunk est utilisée pour ajouter des données à un grand champ de données ou binaire.
Arguments
Data (Variant) Contient la grande quantité de données à ajouter à l'objet Field actuel.
Description
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.
Voir aussi
Propriété Field.Attributes, Enumération FieldAttributeEnum

Propriété Field.Attributes | (Versions 2.0, 2.1, 2.5 et 2.6)
field.Attributes = attributes
La propriété Attributes définit ou renvoie des caractéristiques spécifiques à l'objet Field.
Type de données
Long
Description
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.
Voir aussi
Enumération FieldAttributesEnum

Propriété Field.DataFormat | (Versions 2.0, 2.1, 2.5 et 2.6)
La propriété DataFormat lie l'objet Field en cours à une commande liée aux données.
Type de données
StdDataFormat
Description
La propriété DataFormat est en lecture/écriture. Elle accepte et renvoie un objet StdDataFormat utilisé pour ajouter un objet lié. La propriété DataFormat de l'objet Field n'est pas traitée du tout dans les fichiers d'aide ADO (elle est, toutefois, utilisée dans d'autres objets Microsoft en dehors de l'objet ADO).

Propriété Field.DefinedSize | (Versions 2.0, 2.1, 2.5 et 2.6)
definedsize = field.DefinedSize
La propriété DefinedSize représente la capacité en octets du type de données d'un objet Field.
Type de données
Long
Description
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.
Voir aussi
Propriété Field.ActualSize

Méthode Field.GetChunk | (Versions 2.0, 2.1, 2.5 et 2.6)
Set value = field.GetChunk(NumBytes)
La méthode GetChunk renvoie le nombre spécifié d'octets ou de caractères du champ spécifié.
Arguments
NumBytes Le paramètre NumBytes est une valeur Long représentant le nombre d'octets ou de caractères que vous voulez recevoir.
Valeurs renvoyées
Variant
Description
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.
Voir aussi
Propriété Field.Arguments

Propriété Field.Name | (Versions 2.0, 2.1, 2.5 et 2.6)
Set value = field.GetChunk(NumBytes)
La propriété Name définit le nom de l'objet Field actuel.
Type de données
String
Description
La propriété Name extrait un objet Field de la collection Fields. Les noms ne doivent pas être uniques dans les collections.

Propriété Field.NumericScale | (Versions 2.0, 2.1, 2.5 et 2.6)
field.NumericScale = numericscale
La propriété NumericScale indique l'échelle de valeurs numériques dans l'objet Field actuel.
Type de données
Byte
Description
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.

Propriété Field.OriginalValue | (Versions 2.0, 2.1, 2.5 et 2.6)
originalvalue = field.OriginalValue
La propriété OriginalValue renvoie la valeur qui appartenait à un champ avant l'apport de modifications.
Type de données
Variant
Description
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.
Voir aussi
Méthode Recordset.CancelBatch, Méthode Recordset.CancelUpdate, Méthode Recordset.Update, Méthode Recordset.UpdateBatch

Propriété Field.Precision | (Versions 2.0, 2.1, 2.5 et 2.6)
precision = field.Precision
La propriété Precision représente le degré de précision d'une valeur numérique dans l'objet Field actuel.
Type de données
Byte
Description
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.

Collection Field.Properties | (Versions 2.0, 2.1, 2.5 et 2.6)
Set properties = field.Properties
La collection Properties contient des caractéristiques spécifiques à l'objet Field destinées au fournisseur de données en cours.
Type de données
Properties (objet Collection)
Description
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.

Propriété Field.Status | (Versions 2.5 et 2.6)
status = field.Type
La propriété Status indique l'état de l'objet Field actuel.
Type de données
FieldStatusEnum
Description
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.
Voir aussi
Enumération FieldStatusEnum, Méthode Record.Update, Méthode Recordset.Update

Propriété Field.Type | (Versions 2.0, 2.1, 2.5 et 2.6)
datatype = field.Type
La propriété Type indique le type de données de la propriété Value de l'objet Field.
Type de données
DataTypeEnum
Description
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).
Voir aussi
Enumération DataTypeEnum, Propriété Field.Value, Méthode Fields.Update

Propriété Field.UnderlyingValue | (Versions 2.0, 2.1, 2.5 et 2.6)
underlyingvalue = field.UnderlyingValue
La propriété UnderlyingValue renvoie la valeur actuelle de la propriété Value de l'objet Field.
Type de données
Variant
Description
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.
Voir aussi
Propriété Field.OriginalValue, Propriété Field.Value, Méthode Recordset.Resync

Propriété Field.Value | (Versions 2.0, 2.1, 2.5 et 2.6)
field.Value = value
La propriété Value indique la valeur affectée à l'objet Field actuel.
Type de données
Variant
Description
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.

Collection Fields | (Versions 2.0, 2.1, 2.5 et 2.6)
Set fields = record.Fields Set fields = recordset.Fields
Voir l'objet Field pour plus d'informations et des exemples en rapport avec la collection Fields.
S'applique à
Recordset Offre une vue spécifique d'un groupe d'enregistrements de la connexion associée.
Objects
Field Contient des informations sur un champ unique dans l'enregistrement en cours d'un objet Recordset ouvert.
Méthodes
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.
Propriétés
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.

Méthode Fields.Append | (Versions 2.0, 2.1, 2.5 et 2.6)
Name, Type, DefinedSize, Attrib, FieldValue de fields.Append
La méthode Append ajoute un nouvel objet Field à la collection.
Arguments
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.
Description
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.
Voir aussi
Enumération DataTypeEnum, Enumération FieldAttributeEnum

Méthode Fields.CancelUpdate | (Versions 2.5 et 2.6)
record.Fields.CancelUpdate
La méthode CancelUpdate annule toute modification en attente aux objets Field individuels de la collection Fields de l'objet Record.
Description
Après l'appel à la méthode CancelUpdate, tous les objets Field présentent l'état adFieldOK.
Voir aussi
Objet Record

Propriété Fields.Count | (Versions 2.0, 2.1, 2.5 et 2.6)
count = fields.Count
La propriété Count indique le nombre d'objets Field appartenant à la collection Fields associée.
Type de données
Long
Description
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.

Méthode Fields.Delete | (Versions 2.0, 2.1, 2.5 et 2.6)
Fields.Delete Field
La méthode Delete supprime un objet Field de la collection Fields en cours.
Arguments
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.
Description
Vous ne pouvez appeler la méthode Field.Delete que sur un objet Recordset fermé.

Propriété Fields.Item | (Versions 2.0, 2.1, 2.5 et 2.6)
Set field = fields.Item(Index) Set field = fields(Index)
La propriété Item permet d'accéder à un objet Field spécifique appartenant à la collection Fields.
Type de données
Object
Description
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.
Remarque
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.

Méthode Fields.Refresh | (Versions 2.0, 2.1, 2.5 et 2.6)
Fields.Refresh
D'après la documentation de Microsoft, la méthode Refresh n'exécute aucune fonction visible.
Description
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.
Voir aussi
Méthode Recordset.MoveFirst, Méthode Recordset.Resync

Méthode Fields.Resync | (Versions 2.5 et 2.6)
record.Fields.Resync ResyncValues
La méthode Resync met à jour la collection en cours en tenant compte de la base de données sous-jacente.
Arguments
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.
Description
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.
Voir aussi
Propriété Field.OriginalValue, Propriété Field.Status, Propriété Field.UnderlyingValue, Propriété Field.Value, Enumération ResyncEnum

Méthode Fields.Update | (Versions 2.5 et 2.6)
record.Fields.Update
Description
La méthode Update conserve toute modification en attente à la collection Fields en cours d'un objet Record.
    Dim parameter As ADODB.Parameter