Attribut Attributes de ADO

Retour à la référence du manuel de l'objet ADO Parameter

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 pour inclure 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 parmi elles 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 parmi elles 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 parmi 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 du cache est permise.
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 d'enregistrements spécifique lié à ce champ parent. Souvent, le champ de sous-ensemble est utilisé avec la structure de données ou le filtre 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 dossier 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'espace de stockage des enregistrements.
adFldKeyColumn 0x8000 Ce champ est la clé principale de l'ensemble de lignes de base. Il peut également indiquer que ce champ fait partie d'une clé principale composée.
adFldLong 0x80 Ce champ est un champ binaire long. Il indique également que l'utilisation des méthodes AppendChunk et GetChunk est possible.
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 complet de l'enregistrement à partir de la source de données, mais est récupérée explicitement lors de l'accès à ceux-ci.
adFldNegativeScale 0x4000 Ce champ représente la valeur numérique provenant d'une colonne qui prend en charge des valeurs de plage négatives. La plage est spécifiée par l'attribut NumericScale.
adFldRowID 0x100 Ce champ contient un identifiant persistant, cet identifiant ne peut pas être écrit et n'a aucune signification en dehors de l'indication de la ligne, par exemple le numéro de enregistrement, l'identifiant unique, etc.
adFldRowVersion 0x200 Ce champ contient un certain type de temps ou de date 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 de 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 du jeu de données.
adPropOptional 2 L'utilisateur n'a pas besoin de spécifier la valeur de cette propriété avant l'initialisation du jeu 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 de l'objet ADO Parameter