TyhjennäMakroVirhe-toiminnolla voidaan poistaa MacroError-objektiin tallennetut virhetiedot.
Huomautus: TyhjennäMakroVirhe-makrotoiminto ei ole käytettävissä Access-verkkosovelluksissa.
Asetus
TyhjennäMakroVirhe-toiminnolla ei ole argumentteja.
Huomautuksia
-
Kun makrossa tapahtuu virhe, virheen tiedot tallennetaan MacroError-objektiin. Jos et ole estänyt virhesanomia käyttämällä VirheenYhteydessä-toimintoa, makro pysähtyy ja virheen tiedot tulevat näkyviin vakiovirhesanomaan. Jos kuitenkin olet estänyt virhesanomat käyttämällä VirheenYhteydessä-toimintoa, haluat ehkä käyttää MacroError-objektiin tallennettuja tietoja ehdossa tai mukautetussa virhesanomassa.
Kun virhe on käsitelty, MacroError-objektin tiedot ovat vanhentuneita, joten objekti kannattaa tyhjentää käyttämällä TyhjennäMakroVirhe-toimintoa. Toiminto palauttaa MacroError-objektin virhenumeron nollaksi (0) ja poistaa muut objektiin tallennetut virhetiedot, kuten virheen kuvauksen, makron nimen, toiminnon nimen, ehdon ja argumentit. Näin voit tutkia MacroError-objektia myös myöhemmin, jos haluat nähdä, onko jokin toinen virhe tapahtunut.
-
MacroError-objekti tyhjenee automaattisesti, joten TyhjennäMakroVirhe-toimintoa ei tarvitse käyttää makron lopussa.
-
MacroError-objekti sisältää tietoja vain yhdestä virheestä kerrallaan. Jos makrossa on tapahtunut enemmän kuin yksi virhe, MacroError-objekti sisältää tietoja vain viimeisestä virheestä.
-
Jos haluat suorittaa TyhjennäMakroVirhe-toiminnon VBA-moduulissa, käytä DoCmd-objektin ClearMacroError-menetelmää.
Esimerkki
Seuraava makro estää virhesanomat käyttämällä VirheenYhteydessä-toimintoa Seuraava-argumentin kanssa, ja sen jälkeen se avaa lomakkeen käyttämällä AvaaLomake-toimintoa. Tässä esimerkissä virhe luodaan tarkoituksella käyttämällä SiirryTietueeseen-toimintoa, jolla siirrytään edelliseen tietueeseen. Ehto [MacroError].[Numero]<>0 testaa MacroError-objektia. Jos virhe on tapahtunut, virhenumero ei ole nolla ja Sanomaruutu-toiminto suoritetaan. Sanomaruudussa näkyy virheen aiheuttaneen toiminnon (tässä tapauksessa SiirryTietueeseen-toiminnon) nimi, ja myös virhenumero on näkyvissä. Lopuksi TyhjennäMakroVirhe-toiminnon suorittaminen tyhjentää MacroError-objektin.
Ehto |
Toiminto |
Argumentit |
VirheenYhteydessä |
Siirry: Seuraava |
|
AvaaLomake |
Lomakkeen nimi: LuokkaLomake Näkymä: Lomake Ikkunan näyttötapa: Normaali |
|
SiirryTietueeseen |
Objektin laji: Lomake Objektin nimi: LuokkaLomake Tietue: Edellinen |
|
[MacroError].[Numero]<>0 |
Sanomaruutu |
Sanoma: ="Virhe nro " & [MacroError].[Numero] & " " & [MacroError].[ToiminnonNimi] & " -toiminnossa." Äänimerkki: Kyllä Laji: Tietoja |
TyhjennäMakroVirhe |