ตัวอย่าง
GetRows
ตัวอย่างนี้แสดงให้เห็นถึงวิธีการใช้วิธีการ GetRows
ระเบียนวัตถุ
วัตถุชุดระเบียน ADO ใช้ในการเก็บชุดของระเบียนจากตารางฐานข้อมูล วัตถุระเบียนประกอบด้วยระเบียนและคอลัมน์ (fields)
ใน ADO วัตถุนี้เป็นสิ่งที่สำคัญที่สุดและเป็นหนึ่งที่ใช้บ่อยที่สุดในการจัดการกับข้อมูลจากฐานข้อมูล
ProgID
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 | ผลตอบแทนจริงถ้าตำแหน่งระเบียนปัจจุบันก่อนระเบียนแรกเท็จอย่างอื่น |
| Bookmark | ตั้งค่าหรือผลตอบแทนที่คั่นหน้า บุ๊คมาร์คบันทึกตำแหน่งของระเบียนปัจจุบัน |
| CacheSize | ตั้งหรือส่งกลับจำนวนของระเบียนที่สามารถเก็บไว้ |
| CursorLocation | ตั้งค่าหรือผลตอบแทนสถานที่ตั้งของบริการเคอร์เซอร์ |
| CursorType | ชุดหรือผลตอบแทนประเภทเคอร์เซอร์ของวัตถุระเบียน |
| DataMember | ชุดหรือผลตอบแทนที่ชื่อของสมาชิกของฐานข้อมูลที่จะถูกดึงออกมาจากวัตถุที่อ้างอิงจากแหล่งข้อมูลคุณสมบัติที่ |
| DataSource | ระบุวัตถุที่มีข้อมูลที่จะแสดงเป็นระเบียนวัตถุ |
| EditMode | ส่งคืนสถานะการแก้ไขระเบียนปัจจุบัน |
| EOF | ผลตอบแทนจริงถ้าตำแหน่งระเบียนปัจจุบันคือหลังจากระเบียนสุดท้ายเท็จอย่างอื่น |
| 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 (เฉพาะ Visual Basic, Visual C ++ และ Visual J ++ ภาษาสามารถจัดการเหตุการณ์)
| เหตุการณ์ | ลักษณะ |
|---|---|
| EndOfRecordset | เรียกเมื่อคุณพยายามที่จะย้ายไปยังระเบียนหลังจากระเบียนสุดท้าย |
| FetchComplete | เรียกหลังจากระเบียนทั้งหมดในการดำเนินการไม่ตรงกันได้รับความจริง |
| FetchProgress | เรียกเป็นระยะ ๆ ในการดำเนินการไม่ตรงกันที่จะระบุวิธีการบันทึกอื่น ๆ อีกมากมายที่ได้รับความจริง |
| FieldChangeComplete | เรียกหลังจากค่าของการเปลี่ยนแปลงวัตถุสนาม |
| MoveComplete | เรียกหลังจากที่ตำแหน่งปัจจุบันในระเบียนมีการเปลี่ยนแปลง |
| RecordChangeComplete | เรียกหลังจากบันทึกมีการเปลี่ยนแปลง |
| RecordsetChangeComplete | เรียกหลังจากระเบียนที่มีการเปลี่ยนแปลง |
| WillChangeField | เรียกก่อนที่คุ้มค่าของการเปลี่ยนแปลงวัตถุสนาม |
| WillChangeRecord | เรียกก่อนที่จะมีการเปลี่ยนแปลงการบันทึก |
| WillChangeRecordset | เรียกก่อนที่จะมีการเปลี่ยนแปลงระเบียน |
| WillMove | เรียกก่อนที่ตำแหน่งปัจจุบันในการเปลี่ยนแปลงระเบียน |
คอลเลกชัน
| ชุด | ลักษณะ |
|---|---|
| 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) |