ویژگی Attributes ADO

تعریف و استفاده

ویژگی Attributes می‌تواند یک یا چند ویژگی از شیء را نشان دهد و می‌تواند مقدار طولانی را تنظیم یا بازگرداند.

نکته:هنگام تنظیم چندین ویژگی، می‌توانید مقادیر مناسب را جمع کنید. اگر مقادیر ویژگی‌ها شامل مقادیر غیرقابل سازگار باشند، خطا رخ می‌دهد.

شیء	توضیح ویژگی Attributes
Connection	ویژگی Attributes بر روی شیء Connection دارای مجوز خواندنی و نوشتنی است. و ارزش آن می‌تواند یک یا چند از آنها باشد XactAttributeEnum جمع ارزش‌ها. ارزش پیش‌فرض صفر (0) است.
Parameter	ویژگی Attributes بر روی شیء Parameter دارای مجوز خواندنی و نوشتنی است. و ارزش آن می‌تواند هر یک یا چند از آنها باشد ParameterAttributesEnum جمع ارزش‌ها. ارزش پیش‌فرض adParamSigned است.
Field	وقتی که ویژگی Attributes برای ایجاد Recordset استفاده می‌شود، دارای مجوز خواندنی و نوشتنی است، اما وقتی که یک Recordset موجود را باز می‌کنید، فقط خواندنی است. ویژگی Attributes می‌تواند یک یا چند باشد FieldAttributeEnum جمع ارزش‌ها.
Property	برای شیء Property، ویژگی Attributes فقط خواندنی است. و ارزش آن می‌تواند هر یک یا چند از آنها باشد PropertyAttributesEnum جمع ارزش‌ها.

نحوه استفاده

object.Attributes

مثال

برای شیء Connection:

<%
conn=Server.CreateObject("ADODB.Connection") تنظیم شود
conn.Provider="Microsoft.Jet.OLEDB.4.0"
conn.Open "c:/webdata/northwind.mdb"
response.write(conn.Attributes)
conn.close
%>

برای Field اثرگذار:

<%
conn=Server.CreateObject("ADODB.Connection") تنظیم شود
conn.Provider="Microsoft.Jet.OLEDB.4.0"
conn.Open "c:/webdata/northwind.mdb"
rs = Server.CreateObject("ADODB.Recordset") تنظیم شود
rs.open "Select * from orders", conn
f=Server.CreateObject("ADODB.Field") تنظیم شود
نمایش ویژگی‌های نمونه Field جدول Orders
برای هر f در rs.Fields
  response.write("Attr:" & f.Attributes & "<br />")
  response.write("Name:" & f.Name & "<br />")
  response.write("Value:" & f.Value & "<br />")
Next
rs.Close
conn.close
rs=nothing تنظیم شود
conn=nothing تنظیم شود
%>

برای Property اثرگذار:

<%
conn=Server.CreateObject("ADODB.Connection") تنظیم شود
conn.Provider="Microsoft.Jet.OLEDB.4.0"
conn.Open "c:/webdata/northwind.mdb"
rs = Server.CreateObject("ADODB.Recordset") تنظیم شود
rs.open "Select * from orders", conn
prop=Server.CreateObject("ADODB.Property") تنظیم شود
نمایش ویژگی‌های نمونه Property جدول Orders
برای هر prop در rs.Properties
  response.write("Attr:" & prop.Attributes & "<br />")
  response.write("Name:" & prop.Name & "<br />")
  response.write("Value:" & prop.Value & "<br />")
next
rs.close
conn.close
rs=nothing تنظیم شود
conn=nothing تنظیم شود
%>

مقدار XactAttributeEnum

مقدار ثابت	مقدار	توضیح
adXactAbortRetaining	262144	وقتی که RollbackTrans فراخوانی می‌شود، یک تراکنش جدید به صورت خودکار شروع می‌شود.
adXactCommitRetaining	131072	در هنگام فراخوانی CommitTrans، به طور خودکار یک تراکنش جدید شروع می‌شود.

ارزش‌های ParameterAttributesEnum

مقدار ثابت	مقدار	توضیح
adParamSigned	16	این پارامتر مقادیر مجهول‌العلامت را می‌پذیرد.
adParamNullable	64	این پارامتر مقادیر Null را می‌پذیرد.
adParamLong	128	این پارامتر داده‌های دودویی طولانی را می‌پذیرد.

ارزش‌های FieldAttributeEnum

مقدار ثابت	مقدار	توضیح
adFldCacheDeferred	0x1000	نشان‌دهنده این است که ارائه‌دهنده مقادیر فیلد را در حافظه پشتیبان دارد و نشان‌دهنده این است که می‌توان از مقادیر پشتیبان خواند.
adFldFixed	0x10	نشان‌دهنده این است که این فیلد شامل داده‌های طول ثابت است.
adFldIsChapter	0x2000	نشان‌دهنده این است که این فیلد شامل مقادیر زیر مجموعه است که مقادیر خاصی از مجموعه سطرهای والد را مشخص می‌کند. معمولاً فیلدهای زیر مجموعه با ساختار داده‌ها یا فیلترها استفاده می‌شوند.
adFldIsCollection	0x40000	این فیلد مشخص می‌کند که منابعی که توسط داده‌ها نمایش داده می‌شوند، مجموعه‌ای از منابع دیگر (مانند پوشه) هستند و نه منابع ساده (مانند فایل‌های متنی).
adFldIsDefaultStream	0x20000	این فیلد شامل جریان پیش‌فرض منابعی است که توسط داده‌ها نمایش داده می‌شوند. به عنوان مثال، جریان پیش‌فرض می‌تواند محتوای HTML پوشه ریشه وب‌سایت باشد که در صورت指定 URL ریشه به صورت خودکار ارائه می‌شود.
adFldIsNullable	0x20	این فیلد مقادیر Null را می‌پذیرد.
adFldIsRowURL	0x10000	این فیلد شامل URL است که منابعی را که داده‌های نمایشی آن‌ها را نشان می‌دهد، نام‌گذاری می‌کند.
adFldKeyColumn	0x8000	این فیلد کلید اصلی مجموعه سطرهای پایه است. همچنین نشان‌دهنده این است که این فیلد بخشی از کلید ترکیبی است.
adFldLong	0x80	این فیلد یک فیلد دودویی طولانی است. همچنین نشان‌دهنده این است که می‌توان از روش‌های AppendChunk و GetChunk استفاده کرد.
adFldMayBeNull	0x40	مقادیر Null را می‌توان از این فیلد خواند.
adFldMayDefer	0x2	این فیلد به تأخیر افتاده است، یعنی مقادیر این فیلد نه با کل سطر از منبع داده بازیابی می‌شوند، بلکه در زمان دسترسی آگاهانه به آن‌ها بازیابی می‌شوند.
adFldNegativeScale	0x4000	این فیلد نشان‌دهنده مقادیر عددی از ستون‌هایی است که مقادیر منفی در محدوده دارند. این محدوده توسط ویژگی NumericScale مشخص شده است.
adFldRowID	0x100	این فیلد شامل شناسه پایدار است، این شناسه قابل نوشتن نیست و هیچ معنایی جز شناسه سطر ندارد، به عنوان مثال شماره ثبت، شناسه منحصر به فرد و غیره.
adFldRowVersion	0x200	این فیلد شامل زمان یا تاریخ‌میلادی برای ردیابی به‌روزرسانی‌ها است.
adFldUnknownUpdatable	0x8	ارائه‌دهنده نمی‌تواند تعیین کند که آیا کاربر می‌تواند فیلد را بنویسد یا خیر.
adFldUnspecified	-1 0xFFFFFFFF	ارائه‌دهنده ویژگی فیلد را مشخص نکرده است.
adFldUpdatable	0x4	کاربر می‌تواند فیلد را بنویسد.

مقدار Values PropertyAttributesEnum

مقدار ثابت	مقدار	توضیح
adPropNotSupported	0	ارائه‌دهنده این ویژگی را پشتیبانی نمی‌کند.
adPropRequired	1	قبل از شروع به initialize منبع داده، کاربر باید ارزش این ویژگی را مشخص کند.
adPropOptional	2	قبل از شروع به�始化 منبع داده، کاربر لازم نیست ارزش این ویژگی را مشخص کند.
adPropRead	512	کاربر می‌تواند این ویژگی را بخواند.
adPropWrite	1024	کاربر می‌تواند این ویژگی را تنظیم کند.

برگشت به دستورالعمل‌های موضوع Field ADO

جدول درس

آموزش ADO

شیء ADO

جمع‌بندی ADO

مثال ADO

درس‌های انتخابی

پیشنهاد درس: