أمثلة
GetRows
يوضح هذا المثال كيفية استخدام الأسلوب GetRows.
كائن مجموعة السجلات
يتم استخدام كائن ADO السجلات لعقد مجموعة من السجلات من جدول قاعدة البيانات. يتكون جسم سجلات من سجلات والأعمدة (fields) .
في ADO، هذا الكائن هو أهم واحد وتستخدم في معظم الأحيان لمعالجة البيانات من قاعدة بيانات.
معرف البرنامج
set objRecordset=Server.CreateObject("ADODB.recordset")
عند أول فتح السجلات، ومؤشر السجل الحالي يشير إلى السجل الأول وBOF والخصائص EOF ليست صحيحة. إذا كان هناك أي سجلات، وBOF والممتلكات EOF صحيحة.
يمكن كائنات مجموعة السجلات دعم نوعين من التحديث:
- Immediate updating - أن تكون جميع التغييرات على الفور إلى قاعدة البيانات بمجرد استدعاء الأسلوب تحديث.
- Batch updating - سوف مزود مؤقتا عدة تغييرات ومن ثم إرسالها إلى قاعدة البيانات مع الأسلوب UpdateBatch.
في ADO هناك 4 أنواع مختلفة المؤشر المحدد:
- Dynamic cursor - يسمح لك أن ترى الإضافات، والتغييرات، والحذف من قبل المستخدمين الآخرين.
- Keyset cursor - مثل مؤشر ديناميكي، إلا أنه لا يمكنك مشاهدة الإضافات قبل مستخدمين آخرين، ويمنع الوصول إلى السجلات التي حذف مستخدمين الآخرين. سوف تغير البيانات من قبل مستخدمين آخرين لا تزال مرئية.
- Static cursor - توفر نسخة ثابتة من السجلات لتتمكن من استخدامها للعثور على البيانات أو توليد التقارير. والإضافات، والتغيرات، أو الحذف من قبل المستخدمين الآخرين لا تكون مرئية. هذا هو النوع الوحيد من مؤشر يسمح عند فتح كائن مجموعة السجلات العميل.
- Forward-only cursor - يسمح لك التمرير فقط إلى الأمام من خلال مجموعة السجلات. والإضافات، والتغيرات، أو الحذف من قبل المستخدمين الآخرين لا تكون مرئية.
نوع المؤشر يمكن تعيين بواسطة الخاصية CursorType أو من قبل المعلمة CursorType في الأسلوب فتح.
Note: ليس كل مقدمي دعم كافة أساليب أو خصائص الكائن السجلات.
الخصائص
| خاصية | وصف |
|---|---|
| AbsolutePage | مجموعات أو بإرجاع قيمة يحدد رقم الصفحة في كائن مجموعة السجلات |
| AbsolutePosition | مجموعات أو إرجاع قيمة يحدد موضع ترتيبي من السجل الحالي في كائن مجموعة السجلات |
| ActiveCommand | بإرجاع كائن الأوامر المرتبطة السجلات |
| ActiveConnection | مجموعات أو بإرجاع تعريف للاتصال إذا تم إغلاق الاتصال، أو كائن اتصال الحالي إذا كان الاتصال مفتوحة |
| BOF | عرض true إذا كان الموقف السجل الحالي قبل السجل الأول، كاذبة غير ذلك |
| Bookmark | مجموعات أو إرجاع إشارة مرجعية. العلامة يحفظ موضع السجل الحالي |
| CacheSize | مجموعات أو إرجاع عدد السجلات التي يمكن أن يكون مؤقتا |
| CursorLocation | مجموعات أو إرجاع موقع خدمة المؤشر |
| CursorType | مجموعات أو إرجاع نوع المؤشر من كائن مجموعة السجلات |
| DataMember | مجموعات أو إرجاع اسم عضو البيانات التي سيتم استردادها من الكائن المشار إليه بواسطة الخاصية مصدر البيانات |
| DataSource | تحدد كائن تحتوي على بيانات أن تكون ممثلة ككائن السجلات |
| EditMode | إرجاع الوضع تحرير السجل الحالي |
| EOF | عرض true إذا كان الموقف السجل الحالي بعد السجل الأخير، كاذبة غير ذلك |
| Filter | مجموعات أو إرجاع مرشح للبيانات في كائن مجموعة السجلات |
| Index | مجموعات أو إرجاع اسم الفهرس الحالي لكائن مجموعة السجلات |
| LockType | مجموعات أو إرجاع قيمة التي تحدد نوع التأمين عند تحرير سجل في السجلات |
| MarshalOptions | مجموعات أو إرجاع قيمة التي تحدد السجلات يمكن إرجاعها إلى الخادم |
| MaxRecords | مجموعات أو إرجاع الحد الأقصى لعدد السجلات للعودة إلى كائن سجلات من استعلام |
| PageCount | إرجاع عدد الصفحات مع البيانات في كائن مجموعة السجلات |
| PageSize | مجموعات أو إرجاع الحد الأقصى لعدد السجلات يسمح على صفحة واحدة لكائن مجموعة السجلات |
| RecordCount | إرجاع عدد السجلات في كائن السجلات |
| Sort | مجموعات أو إرجاع أسماء الحقول في مجموعة السجلات لفرز على |
| Source | يحدد قيمة سلسلة أو مرجع كائن الأوامر، أو إرجاع قيمة سلسلة الذي يشير إلى مصدر بيانات من وجوه السجلات |
| State | إرجاع القيمة التي يصف إذا كان الكائن السجلات مفتوحة، مغلقة، الاتصال، تنفيذ أو استرجاع البيانات |
| Status | إرجاع وضع السجل الحالي فيما يتعلق التحديثات دفعة أو العمليات الكبيرة الأخرى |
| StayInSync | مجموعات أو إرجاع ما إذا كانت الإشارة إلى السجلات التابعة تتغير عندما يتغير موقف السجل الأصل |
أساليب
| طريقة | وصف |
|---|---|
| AddNew | يخلق رقما قياسيا جديدا |
| Cancel | يلغي عملية إعدام |
| CancelBatch | يلغي التحديث دفعة |
| CancelUpdate | إلغاء التغييرات التي أدخلت على سجل لكائن مجموعة السجلات |
| Clone | يخلق نسخة مكررة من مجموعة السجلات الموجودة |
| Close | يغلق السجلات |
| CompareBookmarks | يقارن بين العناوين |
| Delete | حذف سجل أو مجموعة من السجلات |
| Find | البحث عن سجل في السجلات التي تلبي معايير محددة |
| GetRows | نسخ سجلات متعددة من كائن مجموعة السجلات إلى صفيف ثنائي الأبعاد |
| GetString | إرجاع سجلات كسلسلة |
| Move | يتحرك المؤشر سجل في كائن مجموعة السجلات |
| MoveFirst | يتحرك مؤشر السجل إلى السجل الأول |
| MoveLast | يتحرك مؤشر السجل إلى السجل الأخير |
| MoveNext | يتحرك مؤشر السجل إلى السجل التالي |
| MovePrevious | يتحرك مؤشر السجل إلى السجل السابق |
| NextRecordset | مسح الكائن السجلات الحالية وإرجاع الكائن السجلات المقبل بواسطة حلقات عبر سلسلة من الأوامر |
| Open | يفتح عنصر قاعدة البيانات التي تمنحك الوصول إلى السجلات في جدول ونتائج استعلام، أو إلى السجلات المحفوظة |
| Requery | بتحديث البيانات في السجلات عن طريق إعادة تنفيذ-الاستعلام التي جعلت من السجلات الأصلي |
| Resync | ينعش البيانات في السجلات الحالي من قاعدة البيانات الأصلية |
| Save | يوفر كائن مجموعة السجلات إلى ملف أو كائن ستريم |
| Seek | يبحث في مؤشر مجموعة سجلات للبحث عن سجل يطابق القيم المحددة |
| Supports | إرجاع القيمة المنطقية التي تحدد ما إذا كان الكائن السجلات يدعم نوع معين من الوظائف |
| Update | يوفر جميع التغييرات التي أدخلت على سجل واحد في كائن السجلات |
| UpdateBatch | يوفر جميع التغييرات في السجلات إلى قاعدة البيانات. تستخدم عند العمل في وضع تحديث دفعة |
أحداث
Note: لا يمكن التعامل مع الأحداث باستخدام VBScript أو ل JScript (فقط مرئي Basic و Visual C ++، واللغات البصرية J ++ يمكن التعامل مع الأحداث).
| هدف | وصف |
|---|---|
| EndOfRecordset | اندلعت عندما حاولت الانتقال إلى سجل بعد السجل الأخير |
| FetchComplete | أثار بعد أن كانت كافة السجلات في عملية غير متزامنة المنال |
| FetchProgress | أثار دوريا في عملية غير متزامنة، القول كم عدد السجلات التي كانت أكثر المنال |
| FieldChangeComplete | أثار بعد قيمة تغيير وجوه الميدان |
| MoveComplete | أثار بعد تغير الوضع الحالي في مجموعة السجلات |
| RecordChangeComplete | أثار بعد تغيير سجل |
| RecordsetChangeComplete | أثار بعد تغير مجموعة السجلات |
| WillChangeField | أثار قبل قيمة تغيير وجوه الميدان |
| WillChangeRecord | أثار قبل تغيير سجل |
| WillChangeRecordset | أثار قبل تغيير السجلات |
| سينتقل | أثار قبل الموضع الحالي في التغييرات السجلات |
مجموعات
| مجموعة | وصف |
|---|---|
| Fields | يشير إلى عدد من الكائنات حقل في كائن مجموعة السجلات |
| Properties | يحتوي على جميع الكائنات العقارات في الكائن السجلات |
خصائص مجموعة حقول ل
| خاصية | وصف |
|---|---|
| Count | إرجاع عدد العناصر في مجموعة من المجالات. يبدأ من الصفر. مثال: countfields = rs.Fields.Count |
| Item(named_item/number) | إرجاع البند المحدد في جمع المجالات. مثال: itemfields = rs.Fields. Item(1) |
خصائص خصائص المجموعة ل
| خاصية | وصف |
|---|---|
| Count | إرجاع عدد العناصر في مجموعة خصائص. يبدأ من الصفر. مثال: countprop = rs.Properties.Count |
| Item(named_item/number) | إرجاع البند المحدد في جمع الممتلكات. مثال: itemprop و= rs.Properties. Item(1) |