Attribut Attributes de ADO

Retour à la référence du manuel Objet Connection ADO

Définition et utilisation

L'attribut Attributes peut définir ou renvoyer une valeur Long, qui peut indiquer une ou plusieurs caractéristiques de l'objet.

Remarque :Lorsque plusieurs attributs sont définis, les constantes appropriées peuvent être additionnées. Si la valeur de l'attribut est définie comme la somme de constantes incompatibles, une erreur se produira.

Objet Description de l'attribut Attributes
Connection L'attribut Attributes a les permissions lecture/écriture pour l'objet Connection. Et sa valeur peut être une ou plusieurs XactAttributeEnum La somme des valeurs. La valeur par défaut est zéro (0).
Parameter L'attribut Attributes a les permissions lecture/écriture pour l'objet Parameter. Et sa valeur peut être une ou plusieurs ParameterAttributesEnum La somme des valeurs. La valeur par défaut est adParamSigned.
Field Lorsque l'attribut Attributes est utilisé pour créer un Recordset, il a les permissions lecture/écriture, mais lorsqu'il ouvre un Recordset existant, il est en lecture seule. L'attribut Attributes peut être une ou plusieurs FieldAttributeEnum La somme des valeurs.
Property Pour l'objet Property, l'attribut Attributes est en lecture seule. Et sa valeur peut être une ou plusieurs d'entre elles PropertyAttributesEnum La somme des valeurs.

Syntaxe

object.Attributes

Instance

Pour l'objet Connection :

<%
set conn=Server.CreateObject("ADODB.Connection")
conn.Provider="Microsoft.Jet.OLEDB.4.0"
conn.Open "c:/webdata/northwind.mdb"
response.write(conn.Attributes)
conn.close
%>

Pour l'objet Field :

<%
set conn=Server.CreateObject("ADODB.Connection")
conn.Provider="Microsoft.Jet.OLEDB.4.0"
conn.Open "c:/webdata/northwind.mdb"
set rs = Server.CreateObject("ADODB.Recordset")
rs.open "Select * from orders", conn
set f=Server.CreateObject("ADODB.Field")
Afficher les attributs des champs de la table Commandes
for each f in rs.Fields
  response.write("Attr:" & f.Attributes & "<br />")
  response.write("Name:" & f.Name & "<br />")
  response.write("Value:" & f.Value & "<br />")
Next
rs.Close
conn.close
set rs=nothing
set conn=nothing
%>

Pour l'objet Property :

<%
set conn=Server.CreateObject("ADODB.Connection")
conn.Provider="Microsoft.Jet.OLEDB.4.0"
conn.Open "c:/webdata/northwind.mdb"
set rs = Server.CreateObject("ADODB.Recordset")
rs.open "Select * from orders", conn
set prop=Server.CreateObject("ADODB.Property")
Afficher les attributs des propriétés de la table Commandes
for each prop in rs.Properties
  response.write("Attr:" & prop.Attributes & "<br />")
  response.write("Name:" & prop.Name & "<br />")
  response.write("Value:" & prop.Value & "<br />")
next
rs.close
conn.close
set rs=nothing
set conn=nothing
%>

Valeur de XactAttributeEnum

Constante Valeur Description
adXactAbortRetaining 262144 Lors de l'appel à RollbackTrans, une nouvelle transaction est automatiquement démarrée.
adXactCommitRetaining 131072 Un nouveau transaction est automatiquement démarré lors de l'appel à CommitTrans.

Valeurs de ParameterAttributesEnum

Constante Valeur Description
adParamSigned 16 Ce paramètre accepte des valeurs signées.
adParamNullable 64 Ce paramètre accepte des valeurs Null.
adParamLong 128 Ce paramètre accepte des données binaires longues.

Valeurs de FieldAttributeEnum

Constante Valeur Description
adFldCacheDeferred 0x1000 Indique que le fournisseur met en cache la valeur du champ et indique que la lecture est effectuée sur le cache.
adFldFixed 0x10 Indique que ce champ contient des données de longueur fixe.
adFldIsChapter 0x2000 Indique que ce champ contient une valeur de sous-ensemble, spécifiant un ensemble de sous-enregistrements spécifique lié à ce champ parent. Souvent, les champs de sous-ensemble sont utilisés avec les structures de données ou les filtres de données.
adFldIsCollection 0x40000 Ce champ spécifie que la ressource représentée par l'enregistrement est une collection de ressources (comme un dossier) et non une ressource simple (comme un fichier texte).
adFldIsDefaultStream 0x20000 Ce champ contient le flux par défaut de la ressource représentée par l'enregistrement. Par exemple, le flux par défaut peut être le contenu HTML du répertoire racine du site Web, fourni automatiquement lors de la spécification de l'URL racine.
adFldIsNullable 0x20 Ce champ accepte des valeurs Null.
adFldIsRowURL 0x10000 Ce champ contient une URL qui nomme la ressource de l'enregistrement dans le stockage de données représenté par l'enregistrement.
adFldKeyColumn 0x8000 Ce champ est la clé principale de l'ensemble de lignes de base. Indique également que ce champ fait partie d'une clé principale composite.
adFldLong 0x80 Ce champ est un champ binaire long. Indique également qu'il est possible d'utiliser les méthodes AppendChunk et GetChunk.
adFldMayBeNull 0x40 Il est possible de lire une valeur Null à partir de ce champ.
adFldMayDefer 0x2 Ce champ est différé, c'est-à-dire que la valeur de ce champ n'est pas récupérée avec l'ensemble de l'enregistrement à partir de la source de données, mais est récupérée explicitement lors de l'accès.
adFldNegativeScale 0x4000 Ce champ représente la valeur numérique venue de la colonne qui supporte des valeurs de plage négatives. La plage est déterminée par l'attribut NumericScale.
adFldRowID 0x100 Ce champ contient un identifiant persistant, cet identifiant ne peut pas être écrit et n'a aucune autre signification que de l'identifiant de ligne, par exemple, le numéro d'enregistrement, l'identifiant unique, etc.
adFldRowVersion 0x200 Ce champ contient une certaine heure ou date-stamp pour suivre les mises à jour.
adFldUnknownUpdatable 0x8 Le fournisseur ne peut pas déterminer si l'utilisateur peut écrire dans le champ.
adFldUnspecified
  • -1
  • 0xFFFFFFFF
 Le fournisseur n'a pas spécifié les attributs du champ.
adFldUpdatable 0x4 L'utilisateur peut écrire dans le champ.

Valeurs PropertyAttributesEnum

Constante Valeur Description
adPropNotSupported 0 Le fournisseur ne prend pas en charge cette propriété.
adPropRequired 1 L'utilisateur doit spécifier la valeur de cette propriété avant l'initialisation de la source de données.
adPropOptional 2 L'utilisateur n'a pas besoin de spécifier la valeur de cette propriété avant l'initialisation de la source de données.
adPropRead 512 L'utilisateur peut lire cette propriété.
adPropWrite 1024 L'utilisateur peut configurer cette propriété.

Retour à la référence du manuel Objet Connection ADO