ADO Status-eigenschap

Terug naar ADO Field Object Referentie Handboek

Definitie en gebruik

De Status-eigenschap kan een FieldStatusEnum Waarde, die de status van het Field-object aangeeft. De standaardwaarde is adFieldOK.

Als het bijwerken mislukt, wordt een fout geretourneerd en geeft de Status-eigenschap de combinatie van de waarde van de operatie en de foutstatuscode aan. De Status-eigenschap van elk Field kan worden gebruikt om de reden te bepalen waarom het Field niet is toegevoegd, gewijzigd of verwijderd.

Problemen met het toevoegen, wijzigen of verwijderen van een Field worden door deze eigenschap gerapporteerd. Voorbeeld, als een gebruiker een veld verwijdert, wordt het in de Fields-collectie gemarkeerd als verwijderd. Als de Update-aanroep fout retourneert omdat de gebruiker probeert een veld te verwijderen waarvoor hij geen rechten heeft, zal de Status van het veld adFieldPermissionDenied of adFieldPendingDelete zijn.

Syntax

objfield.Status

Instance

<%
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
%>

FieldStatusEnum waarde

Constant Waarde Beschrijving
adFieldOK 0 Standaard. Indicatie dat het veld succesvol is toegevoegd of verwijderd.
adFieldCantConvertValue 2 Het is niet mogelijk om het veld op te halen of op te slaan zonder gegevens te verliezen.
adFieldIsNull 3 De leverancier retourneert een Null-waarde.
adFieldTruncated 4 De leverancier retourneert variabele lengte gegevens die zijn afgekapt bij het lezen van de gegevens van de bron.
adFieldSignMismatch 5 De leverancier retourneert een getal met een teken, terwijl het datatype van de waarde van het ADO-veld geen teken heeft.
adFieldDataOverflow 6 De leverancier retourneert gegevens die buiten het datatype van het veld vallen.
adFieldCantCreate 7 De leverancier kan het veld niet toevoegen omdat de leverancier de limiet heeft overschreden (bijvoorbeeld het aantal toegestane velden).
adFieldUnavailable 8 De leverancier kan de waarde niet bepalen bij het lezen van de gegevens van de bron. Bijvoorbeeld, een rij is net worden gemaakt, de standaardwaarde van de kolom kan niet worden gebruikt, en er is geen nieuwe waarde is aangegeven.
adFieldPermissionDenied 9 Indicatie dat het veld niet kan worden gewijzigd omdat het als alleen-lezen is gedefinieerd.
adFieldIntegrityViolation 10 Indicatie dat het veld niet kan worden gewijzigd omdat het een berekend of afgeleid item is.
adFieldSchemaViolation 11 Indicatie dat de waarde de beperkingen van het schema van de datasource voor het veld overtreedt.
adFieldBadStatus 12 Indicatie dat een ongeldige statuswaarde is verzonden van ADO naar de OLE DB-provider. De oorzaak kan een OLE DB 1.0 of 1.1 provider zijn, of een onjuiste combinatie van Value en Status.
adFieldDefault 13 Indicatie dat de standaardwaarde van het veld is gebruikt bij het instellen van de gegevens.
adFieldIgnore 15 Indicatie dat tijdens het instellen van de waarde van de gegevens in de bron, dit veld wordt overgeslagen. De provider heeft geen waarde ingesteld.
adFieldDoesNotExist 16 Indicatie dat het opgegeven veld niet bestaat.
adFieldInvalidURL 17 Indicatie dat de datasource URL ongeldige karakters bevat.
adFieldResourceLocked 18 Indicatie dat de provider de actie niet kan uitvoeren omdat de datasource wordt gelockt door een of meerdere andere toepassingen of processen.
adFieldResourceExists 19 Indicatie dat de provider de actie niet kan uitvoeren omdat het object al bestaat in de doelspecificatie URL en niet kan worden overschreven.
adFieldCannotComplete 20 Indicatie dat de server, gespecificeerd door de URL van de Source, de actie niet kan voltooien.
adFieldVolumeNotFound 21 Indicatie dat de provider de opgeslagen hoeveelheid, aangegeven door de URL, niet kan lokaliseren.
adFieldOutOfSpace 22 Indicatie dat de provider niet genoeg opslagruimte heeft om de verplaatsings- of kopiëeractie te voltooien.
adFieldCannotDeleteSource 23 Indicatie dat tijdens de verplaatsingsactie de boom of subboom naar een nieuwe positie is verplaatst, maar dat de bron niet kan worden verwijderd.
adFieldReadOnly 24 Indicatie dat het veld in de datasource als alleen-lezen is gedefinieerd.
adFieldResourceOutOfScope 25 Indicatie dat de bron- of doelspecificatie URL buiten het bereik van het huidige record valt.
adFieldAlreadyExists 26 Indicatie dat het opgegeven veld al bestaat.
adFieldPendingInsert 0x10000 De Append-actie vereist het instellen van de status. Field wordt gemarkeerd als toegevoegd aan de Fields-collectie na het aanroepen van de Update-methode.
adFieldPendingDelete 0x20000 Geef aan dat de Delete-actie heeft geleid tot het instellen van de status. Het veld wordt gemarkeerd om te worden verwijderd uit de Fields-collectie nadat de Update-methode is aangeroepen.
adFieldPendingChange 0x40000 Geef aan dat het veld is verwijderd en opnieuw is toegevoegd (mogelijk met een andere datatype), of dat de waarde van een veld dat eerder de status adFieldOK had, is gewijzigd. De uiteindelijke indeling van het veld zal worden aangepast in de Fields-collectie nadat de Update-methode is aangeroepen.
adFieldPendingUnknown 0x80000 Geef aan dat de leverancier niet kan bepalen welke actie heeft geleid tot het instellen van de status.
adFieldPendingUnknownDelete 0x100000 Geef aan dat de leverancier niet kan bepalen welke actie heeft geleid tot het instellen van de veldstatus, en dat het veld na het aanroepen van de Update-methode zal worden verwijderd uit de Fields-collectie.

Terug naar ADO Field Object Referentie Handboek