خطا (ADO Error)
«خطای ADO (ADO Error)» یعنی گزارشی از مشکل دسترسی داده. این گزارش برای هر خطا یک شیء می سازد و آن ها را در مجموعه Errors نگه می دارد؛ مثل دفتر انضباطی مدرسه که برای هر اشتباه یک برگه دارد.
آبجکت Error چیست؟
هر عملیات داده ممکن است خطا بدهد. سپس ADO یک شیء Error می سازد و داخل مجموعه Errors در همان Connection ذخیره می کند. بنابراین باید به Connection ارجاع بدهی تا این خطاها را ببینی.
پیمایش مجموعه Errors
با یک حلقه ساده، تمام خطاها را می خوانیم و جزئیات را می نویسیم. «توضیح (Description)» پیام خطاست. «منبع (Source)» سازنده خطاست. «کد بومی (NativeError)» کد خطای فراهم کننده است.
<%
for each objErr in objConn.Errors
response.write("<p>")
response.write("Description: ")
response.write(objErr.Description & "<br>")
response.write("Help context: ")
response.write(objErr.HelpContext & "<br>")
response.write("Help file: ")
response.write(objErr.HelpFile & "<br>")
response.write("Native error: ")
response.write(objErr.NativeError & "<br>")
response.write("Error number: ")
response.write(objErr.Number & "<br>")
response.write("Error source: ")
response.write(objErr.Source & "<br>")
response.write("SQL state: ")
response.write(objErr.SQLState & "<br>")
response.write("</p>")
next
%>
سینتکس دسترسی
برای دسترسی به ویژگی ها، از الگوی ساده زیر استفاده کن.
objErr.property
ویژگی های مهم Error
کلیدی ترین ها: Description، HelpContext، HelpFile، NativeError، Number، Source، و SQLState. هرکدام اطلاعاتی متفاوت می دهند؛ مثل نام، شماره، و مسیر راهنما.
گام های عملی عیب یابی
- Connection را مشخص کن و عملیات را اجرا کن.
- اگر خطا شد، مجموعه Errors را بررسی کن.
- توضیح و شماره خطا را لاگ کن.
- براساس SQLState یا NativeError تصمیم بگیر.
- در پایان، Connection را تمیز ببند.
نکته: همیشه بعد از هر کوئری مهم، مجموعه Errors را چک کن؛ مخصوصاً وقتی چند خطا پشت سرهم ممکن است رخ دهد.
برای مطالعه مرتبط، به اتصال ADO و فرمان ADO سر بزن. همچنین صفحه خطای ADO را نشانه گذاری کن.
جمع بندی سریع
- هر خطا یک شیء Error دارد.
- همه خطاها در Errors جمع می شوند.
- برای دیدن خطاها، Connection لازم است.
- Description و Number را حتماً لاگ کن.