ADO Status-ominaisuus

Palaa ADO Field-objektin viitetietokirjaan

Määrittely ja käyttö

Status-ominaisuus voi palauttaa FieldStatusEnum Arvo, joka viittaa Field-objektin tilaan. Oletusarvo on adFieldOK.

Jos päivitys epäonnistuu, palautetaan virhe ja Status-ominaisuus viittaa operaation yhdistettyyn arvoon ja virheen tilakoodiin. Jokaisen Fieldin Status-ominaisuus voidaan käyttää määrittämään, miksi tätä Fieldiä ei ole lisätty, muokattu tai poistettu.

Kysymykset, jotka liittyvät johonkin Fieldin lisäämiseen, muokkaamiseen tai poistamiseen, raportoidaan tämän ominaisuuden kautta. Esimerkiksi, jos käyttäjä poistaa kentän, se merkittyy poistetuksi Fields-kokoelmassa. Jos käyttäjä yrittää poistaa kentän, jota hän ei voi poistaa, ja Update-kutsu palauttaa virheen, kentän Status on adFieldPermissionDenied tai adFieldPendingDelete.

Syntaksi

objfield.Status

Esimerkki

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

Vakioint Arvo Kuvaus
adFieldOK 0 Oletus. Ohjeesta, että kenttä on onnistuneesti lisätty tai poistettu.
adFieldCantConvertValue 2 Ohjeesta, että kenttää ei voida hakea tai tallentaa ilman tietojen menetystä.
adFieldIsNull 3 Ohjeesta, että tarjoaja palautti Null-arvon.
adFieldTruncated 4 Ohjeesta, että muuttuva tieto on katkaistu tietolähteen lukemisen yhteydessä.
adFieldSignMismatch 5 Ohjeesta, että tarjoajan palauttama arvo on merkittävä, mutta ADO-kentän arvon tietotyyppi ei ole merkittävä.
adFieldDataOverflow 6 Ohjeesta, että tarjoajan palauttama tieto ylittää kentän tietotyyppisi.
adFieldCantCreate 7 Ohjeesta, että tarjoaja ylitti rajat (esim. sallitun kenttien määrän), joten kenttää ei voida lisätä.
adFieldUnavailable 8 Ohjeesta, että tarjoaja ei voi määrittää arvoa tietolähteen lukemisen yhteydessä. Esimerkiksi, rivi on juuri luotu, sarakkeen oletusarvoa ei voida käyttää, eikä uutta arvoa ole määritelty.
adFieldPermissionDenied 9 Merkitsee, että kenttää ei voida muokata, koska se on määritelty vain lukuun tarkoitetuksi.
adFieldIntegrityViolation 10 Merkitsee, että kenttää ei voida muokata, koska se on laskettu tai johdettu tietue.
adFieldSchemaViolation 11 Merkitsee, että arvo rikkoo kentän tietolähteen mallin rajoitukset.
adFieldBadStatus 12 Merkitsee, että ADO:sta OLE DB -tarjoajalle lähetettiin epäkelvollinen tila-arvo. Syy voi olla OLE DB 1.0 tai 1.1 -tarjoaja tai arvon ja tilan yhdistelmän epäasianmukaisuus.
adFieldDefault 13 Merkitsee, että kentän oletusarvoa käytettiin tietojen asettamiseen.
adFieldIgnore 15 Merkitsee, että tämä kenttä ohitetaan asettaessa lähdettä olevia tietoja. Tarjoaja ei aseta arvoa.
adFieldDoesNotExist 16 Merkitsee, että määritetty kenttä ei ole olemassa.
adFieldInvalidURL 17 Merkitsee, että tietolähteen URL sisältää epäkelvollisia merkkejä.
adFieldResourceLocked 18 Merkitsee, että tarjoaja ei voi suorittaa operatiota, koska tietolähde on lukittu yhdellä tai useammalla muulla sovelluksella tai prosessilla.
adFieldResourceExists 19 Merkitsee, että tarjoaja ei voi suorittaa operatiota, koska objekti on jo olemassa kohde-URL:ssa ja sitä ei voida korvata.
adFieldCannotComplete 20 Merkitsee, että lähde-URL:ää osoittava Source-palvelin ei voi suorittaa operatiota.
adFieldVolumeNotFound 21 Merkitsee, että tarjoaja ei voi sijoittaa URL:ää osoittamaan tallennustilaa.
adFieldOutOfSpace 22 Merkitsee, että tarjoaja ei voi saada tarvittavaa tallennustilaa suorittaakseen siirto- tai kopiointi-操作kion.
adFieldCannotDeleteSource 23 Merkitsee, että siirto-操作ksessa puu tai alipuu on siirretty uuteen sijaintiin, mutta lähdettä ei voida poistaa.
adFieldReadOnly 24 Merkitsee, että tietolähteessä oleva kenttä on määritelty vain lukuun tarkoitetuksi.
adFieldResourceOutOfScope 25 Merkitsee, että lähde- tai kohde-URL ylittää nykyisen rekisterin laajuuden.
adFieldAlreadyExists 26 Merkitsee, että määritetty kenttä on jo olemassa.
adFieldPendingInsert 0x10000 Append-toiminto edellyttää tilan asettamista. Field on merkitty lisättäväksi Fields-kokoelmaan Update-metodin kutsun jälkeen.
adFieldPendingDelete 0x20000 Viittaa siihen, että Delete-toiminto aiheutti tarpeen asettaa tila. Kenttä merkataan poistettavaksi Fields-kohteesta, kun Update-metodia kutsutaan.
adFieldPendingChange 0x40000 Viittaa siihen, että kenttä poistettiin ja lisättiin uudelleen (mahdollisesti eri datatyypillä), tai viittaa siihen, että aikaisemmin adFieldOK-tilassa ollut kentän arvo on muuttunut. Kentän lopullinen muoto muutetaan Fields-kohteessa, kun Update-metodia kutsutaan.
adFieldPendingUnknown 0x80000 Viittaa siihen, että tarjoaja ei voi määrittää, mikä toiminta aiheutti tarpeen asettaa tila.
adFieldPendingUnknownDelete 0x100000 Viittaa siihen, että tarjoaja ei voi määrittää, mikä toiminta aiheutti tarpeen asettaa kenttätila, ja kenttä poistetaan Fields-kohteesta, kun Update-metodia kutsutaan.

Palaa ADO Field-objektin viitetietokirjaan