ADO Recordset Object
ဥပမာများ
ဤဥပမာသည် GetRows နည်းလမ်းကိုအသုံးပြုပုံကို သရုပ်ပြသည်။
Recordset Object
ADO Recordset အရာဝတ္တုကို ဒေတာဘေ့စ်ဇယားတစ်ခုမှ မှတ်တမ်းအစုအဝေးကို ထိန်းထားရန် အသုံးပြုသည်။ Recordset အရာဝတ္ထုတွင် မှတ်တမ်းများနှင့် ကော်လံများ (အကွက်များ) ပါ၀င်သည်။
ADO တွင်၊ ဤအရာဝတ္ထုသည် အရေးကြီးဆုံးဖြစ်ပြီး ဒေတာဘေ့စ်တစ်ခုမှ အချက်အလက်များကို ကိုင်တွယ်ရန် မကြာခဏအသုံးပြုသည့် အရာဖြစ်သည်။
ProgID
set objRecordset=Server.CreateObject("ADODB.recordset")
Recordset တစ်ခုကို သင်ပထမဆုံးဖွင့်သောအခါတွင်၊ လက်ရှိ record pointer သည် ပထမဆုံး record ကိုညွှန်ပြမည်ဖြစ်ပြီး BOF နှင့် EOF ဂုဏ်သတ္တိများသည် False ဖြစ်သည်။ မှတ်တမ်းများမရှိပါက BOF နှင့် EOF ပိုင်ဆိုင်မှုများသည် မှန်ပါသည်။
Recordset အရာဝတ္ထုများသည် အဆင့်မြှင့်တင်ခြင်း အမျိုးအစားနှစ်မျိုးကို ပံ့ပိုးပေးနိုင်သည်-
- ချက်ခြင်းမွမ်းမံခြင်း - အပ်ဒိတ်နည်းလမ်းကို သင်ခေါ်ဆိုပြီးသည်နှင့် ပြောင်းလဲမှုအားလုံးကို ဒေတာဘေ့စ်တွင် ချက်ခြင်းရေးသားပါသည်။
- အစုလိုက်အပ်ဒိတ်လုပ်ခြင်း - ဝန်ဆောင်မှုပေးသူက အပြောင်းအလဲများစွာကို ကက်ရှ်လုပ်ပြီးနောက် UpdateBatch နည်းလမ်းဖြင့် ဒေတာဘေ့စ်သို့ ပို့ပေးပါမည်။
ADO တွင် သတ်မှတ်ထားသော ကာဆာအမျိုးအစား 4 မျိုးရှိသည်။
- Dynamic cursor - အခြားအသုံးပြုသူများ၏ ထပ်လောင်းမှုများ၊ ပြောင်းလဲမှုများနှင့် ဖျက်မှုများကို ကြည့်ရှုနိုင်စေပါသည်။
- Keyset cursor - အခြားအသုံးပြုသူများ၏ ထပ်လောင်းထည့်မှုများကို သင်မမြင်နိုင်ပါကလွဲ၍ ရွေ့လျားနိုင်သော cursor ကဲ့သို့ဖြစ်ပြီး ၎င်းသည် အခြားအသုံးပြုသူများဖျက်လိုက်သော မှတ်တမ်းများသို့ ဝင်ရောက်ခွင့်ကို တားဆီးပေးပါသည်။ အခြားအသုံးပြုသူများ၏ ဒေတာပြောင်းလဲမှုများကို မြင်နိုင်မည်ဖြစ်သည်။
- Static cursor - ဒေတာရှာဖွေရန် သို့မဟုတ် အစီရင်ခံစာများထုတ်ရန် သင်အသုံးပြုရန်အတွက် အသုံးပြုရန်အတွက် မှတ်တမ်းအစုံ၏ တည်ငြိမ်သောမိတ္တူကို ပေးပါသည်။ အခြားအသုံးပြုသူများ၏ ထပ်လောင်းမှုများ၊ ပြောင်းလဲမှု သို့မဟုတ် ဖျက်ခြင်းများကို မြင်နိုင်မည်မဟုတ်ပေ။ ဤသည်မှာ client-side Recordset အရာဝတ္ထုကို သင်ဖွင့်သည့်အခါ ခွင့်ပြုထားသော တစ်ခုတည်းသော cursor အမျိုးအစားဖြစ်သည်။
- ထပ်ဆင့်-သီးသန့် ကာဆာ - သင့်အား Recordset မှတဆင့် ရှေ့သို့သာ လှိမ့်ကြည့်ရန် ခွင့်ပြုသည်။ အခြားအသုံးပြုသူများ၏ ထပ်လောင်းမှုများ၊ ပြောင်းလဲမှု သို့မဟုတ် ဖျက်ခြင်းများကို မြင်နိုင်မည်မဟုတ်ပေ။
Cursor အမျိုးအစားကို CursorType ပိုင်ဆိုင်မှုအားဖြင့် သို့မဟုတ် Open method ရှိ CursorType ဘောင်ဖြင့် သတ်မှတ်နိုင်သည်။
မှတ်ချက်- ပံ့ပိုးသူအားလုံးသည် Recordset အရာဝတ္တု၏ နည်းလမ်းများ သို့မဟုတ် ဂုဏ်သတ္တိအားလုံးကို မပံ့ပိုးပါ။
သတ္တိ
| Property | Description |
|---|---|
| AbsolutePage | Sets or returns a value that specifies the page number in the Recordset object |
| AbsolutePosition | Sets or returns a value that specifies the ordinal position of the current record in the Recordset object |
| ActiveCommand | Returns the Command object associated with the Recordset |
| ActiveConnection | Sets or returns a definition for a connection if the connection is closed, or the current Connection object if the connection is open |
| BOF | Returns true if the current record position is before the first record, otherwise false |
| Bookmark | Sets or returns a bookmark. The bookmark saves the position of the current record |
| CacheSize | Sets or returns the number of records that can be cached |
| CursorLocation | Sets or returns the location of the cursor service |
| CursorType | Sets or returns the cursor type of a Recordset object |
| DataMember | Sets or returns the name of the data member that will be retrieved from the object referenced by the DataSource property |
| DataSource | Specifies an object containing data to be represented as a Recordset object |
| EditMode | Returns the editing status of the current record |
| EOF | Returns true if the current record position is after the last record, otherwise false |
| Filter | Sets or returns a filter for the data in a Recordset object |
| Index | Sets or returns the name of the current index for a Recordset object |
| LockType | Sets or returns a value that specifies the type of locking when editing a record in a Recordset |
| MarshalOptions | Sets or returns a value that specifies which records are to be returned to the server |
| MaxRecords | Sets or returns the maximum number of records to return to a Recordset object from a query |
| PageCount | Returns the number of pages with data in a Recordset object |
| PageSize | Sets or returns the maximum number of records allowed on a single page of a Recordset object |
| RecordCount | Returns the number of records in a Recordset object |
| Sort | Sets or returns the field names in the Recordset to sort on |
| Source | Sets a string value or a Command object reference, or returns a String value that indicates the data source of the Recordset object |
| State | Returns a value that describes if the Recordset object is open, closed, connecting, executing or retrieving data |
| Status | Returns the status of the current record with regard to batch updates or other bulk operations |
| StayInSync | Sets or returns whether the reference to the child records will change when the parent record position changes |
နည်းလမ်းများ
| Method | Description |
|---|---|
| AddNew | Creates a new record |
| Cancel | Cancels an execution |
| CancelBatch | Cancels a batch update |
| CancelUpdate | Cancels changes made to a record of a Recordset object |
| Clone | Creates a duplicate of an existing Recordset |
| Close | Closes a Recordset |
| CompareBookmarks | Compares two bookmarks |
| Delete | Deletes a record or a group of records |
| Find | Searches for a record in a Recordset that satisfies a specified criteria |
| GetRows | Copies multiple records from a Recordset object into a two-dimensional array |
| GetString | Returns a Recordset as a string |
| Move | Moves the record pointer in a Recordset object |
| MoveFirst | Moves the record pointer to the first record |
| MoveLast | Moves the record pointer to the last record |
| MoveNext | Moves the record pointer to the next record |
| MovePrevious | Moves the record pointer to the previous record |
| NextRecordset | Clears the current Recordset object and returns the next Recordset object by looping through a series of commands |
| Open | Opens a database element that gives you access to records in a table, the results of a query, or to a saved Recordset |
| Requery | Updates the data in a Recordset by re-executing the query that made the original Recordset |
| Resync | Refreshes the data in the current Recordset from the original database |
| Save | Saves a Recordset object to a file or a Stream object |
| Seek | Searches the index of a Recordset to find a record that matches the specified values |
| Supports | Returns a boolean value that defines whether or not a Recordset object supports a specific type of functionality |
| Update | Saves all changes made to a single record in a Recordset object |
| UpdateBatch | Saves all changes in a Recordset to the database. Used when working in batch update mode |
အဲ့ဒါနဲ့
မှတ်ချက်- VBScript သို့မဟုတ် JScript ကို အသုံးပြု၍ အဖြစ်အပျက်များကို သင် မကိုင်တွယ်နိုင်ပါ (Visual Basic၊ Visual C++ နှင့် Visual J++ ဘာသာစကားများကသာ ဖြစ်ရပ်များကို ကိုင်တွယ်နိုင်သည်)။
| Event | Description |
|---|---|
| EndOfRecordset | Triggered when you try to move to a record after the last record |
| FetchComplete | Triggered after all records in an asynchronous operation have been fetched |
| FetchProgress | Triggered periodically in an asynchronous operation, to state how many more records that have been fetched |
| FieldChangeComplete | Triggered after the value of a Field object change |
| MoveComplete | Triggered after the current position in the Recordset has changed |
| RecordChangeComplete | Triggered after a record has changed |
| RecordsetChangeComplete | Triggered after the Recordset has changed |
| WillChangeField | Triggered before the value of a Field object change |
| WillChangeRecord | Triggered before a record change |
| WillChangeRecordset | Triggered before a Recordset change |
| WillMove | Triggered before the current position in the Recordset changes |
စုစည်းမှုများ
| Collection | Description |
|---|---|
| Fields | Indicates the number of Field objects in the Recordset object |
| Properties | Contains all the Property objects in the Recordset object |
Fields Collection ၏ ဂုဏ်သတ္တိများ
| Property | Description |
|---|---|
| Count | Returns the number of items in the fields collection. Starts at zero.
Example: countfields=rs.Fields.Count |
| Item(named_item/number) | Returns a specified item in the fields collection.
Example: itemfields=rs.Fields.Item(1) |
Properties Collection ၏ Properties
| Property | Description |
|---|---|
| Count | Returns the number of items in the properties collection. Starts at zero.
Example: countprop=rs.Properties.Count |
| Item(named_item/number) | Returns a specified item in the properties collection.
Example: itemprop = rs.Properties.Item(1) |