خصائص ADO Attributes

العودة إلى دليل مرجعي Field ADO

التعريف والاستخدام

يمكن تعيين أو إرجاع خاصية Attributes قيمة Long، التي يمكن أن تشير إلى خصائص واحدة أو أكثر من العنصر.

ملاحظة:عندما يتم تعيين عدة خصائص، يمكن إضافة القيم المناسبة. إذا تم تعيين قيمة الخصائص لتشمل مجموعًا من القيم غير المتوافقة، فإنه سيحدث خطأ.

عنصر وصف خاصية Attributes
Connection يملك خاصية Attributes الصلاحيات للقراءة والكتابة على Object الاتصال. وهي يمكن أن تكون قيمة واحدة أو أكثر XactAttributeEnum مجموع القيم. القيمة الافتراضية هي صفر (0).
Parameter يملك خاصية Attributes الصلاحيات للقراءة والكتابة على Object Parameter. وهي يمكن أن تكون أي قيمة واحدة أو أكثر ParameterAttributesEnum مجموع القيم. القيمة الافتراضية هي adParamSigned.
Field عندما يتم استخدام خاصية Attributes لإنشاء Recordset، يملك الصلاحيات للقراءة والكتابة، ولكن عندما تفتح Recordset موجودًا، فهي غير قابلة للتعديل. يمكن أن تكون خاصية Attributes قيمة واحدة أو أكثر FieldAttributeEnum مجموع القيم.
Property بالنسبة لـ Object Property،属性 Attributes غير قابلة للتعديل. وهي يمكن أن تكون أي قيمة واحدة أو أكثر PropertyAttributesEnum مجموع القيم.

النحو

object.Attributes

مثال

عن Object الاتصال：

<%
set 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 Object:

<%
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
set f=Server.CreateObject("ADODB.Field")
عرض صفات الحقول لجدول الطلبات
for each f in rs.Fields
  response.write("صفة:" & f.Attributes & "<br />")
  response.write("اسم:" & f.Name & "<br />")
  response.write("قيمة:" & f.Value & "<br />")
Next
rs.Close
conn.close
set rs=nothing
set conn=nothing
%>

بالنسبة لـ Property Object:

<%
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
set prop=Server.CreateObject("ADODB.Property")
عرض صفات خصائص جدول الطلبات
for each prop in rs.Properties
  response.write("صفة:" & prop.Attributes & "<br />")
  response.write("اسم:" & prop.Name & "<br />")
  response.write("قيمة:" & prop.Value & "<br />")
next
rs.close
conn.close
set rs=nothing
set 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 يمكن للمستخدم كتابة الحقل.

قيم PropertyAttributesEnum

القيم القيمة الوصف
adPropNotSupported 0 لا يدعم المزود هذه الخاصية.
adPropRequired 1 يجب على المستخدم تحديد قيمة هذه الخاصية قبل بدء تحميل بيانات المصدر.
adPropOptional 2 لا يجب على المستخدم تحديد قيمة هذه الخاصية قبل بدء تحميل بيانات المصدر.
adPropRead 512 يمكن للمستخدم قراءة هذه الخاصية.
adPropWrite 1024 يمكن للمستخدم تعيين هذه الخاصية.

العودة إلى دليل مرجعي Field ADO