Propriété d' état ADO
❮ Compléter la référence d'objet de champ
La propriété Status renvoie une valeur FieldStatusEnum qui indique l'état d'un objet Field. La valeur par défaut est adFieldOK.
Si des mises à jour échouent, une erreur est renvoyée et la propriété Status indique les valeurs combinées du code d'état de l'opération et de l'erreur. La propriété Status de chaque champ peut être utilisée pour déterminer pourquoi le champ n'a pas été ajouté, modifié ou supprimé.
Les problèmes d'ajout, de modification ou de suppression d'un champ sont signalés via cette propriété. Par exemple, si un utilisateur supprime un champ, il sera marqué pour suppression dans la collection Fields. Si l'appel de mise à jour renvoie une erreur parce que l'utilisateur a tenté de supprimer un champ pour lequel il n'a pas l'autorisation, le statut de ce champ sera adFieldPermissionDenied ou adFieldPendingDelete.
Syntaxe
objfield.Status
Exemple
<%
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
response.write(rs.Fields(0).Status)
rs.Close
conn.close
%>
Valeurs FieldStatusEnum
| Constant | Value | Description |
|---|---|---|
| adFieldOK | 0 | Default. The field was successfully added or deleted |
| adFieldCantConvertValue | 2 | The field cannot be retrieved or stored without loss of data |
| adFieldIsNull | 3 | The provider returned a null value |
| adFieldTruncated | 4 | Variable-length data was truncated when reading from the data source |
| adFieldSignMismatch | 5 | The data value returned by the provider was signed, but the data type of the ADO field value was unsigned |
| adFieldDataOverflow | 6 | The data returned from the provider overflowed the data type of the field |
| adFieldCantCreate | 7 | The field could not be added because the provider exceeded a limitation |
| adFieldUnavailable | 8 | The provider could not determine the value when reading from the data source |
| adFieldPermissionDenied | 9 | The field cannot be modified because it is read-only |
| adFieldIntegrityViolation | 10 | The field cannot be modified because it is a calculated or derived entity |
| adFieldSchemaViolation | 11 | The value violated the data source schema constraint for the field |
| adFieldBadStatus | 12 | An invalid status value was sent from ADO to the OLE DB provider |
| adFieldDefault | 13 | The default value for the field was used when setting data |
| adFieldIgnore | 15 | This field was skipped when setting data values in the source |
| adFieldDoesNotExist | 16 | The field does not exist |
| adFieldInvalidURL | 17 | The data source URL contains invalid characters |
| adFieldResourceLocked | 18 | The provider cannot perform the operation because the data source is locked |
| adFieldResourceExists | 19 | The provider cannot perform the operation because an object already exists at the destination URL and it is not able to overwrite the object |
| adFieldCannotComplete | 20 | The server of the URL specified by Source could not complete the operation |
| adFieldVolumeNotFound | 21 | The provider is unable to locate the storage volume indicated by the URL |
| adFieldOutOfSpace | 22 | The provider is unable to obtain enough storage space to complete a move or copy operation |
| adFieldCannotDeleteSource | 23 | During a move operation, a tree or subtree was moved to a new location, but the source could not be deleted |
| adFieldReadOnly | 24 | The field in the data source is read-only |
| adFieldResourceOutOfScope | 25 | A source or destination URL is outside the scope of the current record |
| adFieldAlreadyExists | 26 | The specified field already exists |
| adFieldPendingInsert | 0x10000 | The Append operation caused the status to be set. The field has been marked to be added to the Fields collection after the Update method is called |
| adFieldPendingDelete | 0x20000 | The Delete operation caused the status to be set. The field has been marked for deletion from the Fields collection after the Update method is called |
| adFieldPendingChange | 0x40000 | The field has been deleted and then re-added or the value of the field which previously had a status of adFieldOK has changed |
| adFieldPendingUnknown | 0x80000 | The provider cannot determine what operation caused field status to be set |
| adFieldPendingUnknownDelete | 0x100000 | The provider cannot determine what operation caused field status to be set, and that the field will be deleted from the Fields collection after the Update method is called. |
❮ Compléter la référence d'objet de champ