ویژگی Attributes ADO

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

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

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

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

شیء توضیح ویژگی 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
%>

برای object 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("ویژگی:" & f.Attributes & "<br />")
  response.write("نام:" & f.Name & "<br />")
  response.write("مقدار:" & f.Value & "<br />")
Next
rs.Close
conn.close
rs=nothing تنظیم شود
conn=nothing تنظیم شود
%>

برای Property object:

<%
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("ویژگی:" & prop.Attributes & "<br />")
  response.write("نام:" & prop.Name & "<br />")
  response.write("مقدار:" & prop.Value & "<br />")
next
rs.close
conn.close
rs=nothing تنظیم شود
conn=nothing تنظیم شود
%>

مقدار XactAttributeEnum

مقدار ثابت مقدار توضیح
adXactAbortRetaining 262144 وقتی که RollbackTrans فراخوانی می‌شود، یک تراکنش جدید به صورت خودکار شروع می‌شود.
ادXactCommitRetaining 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 کاربر می‌تواند حقل را بنویسد.

مقدار‌های PropertyAttributesEnum

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

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