ADO Recordset ऑब्जैक्ट
- पिछला पृष्ठ ADO Record
- अगला पृष्ठ ADO Stream
उदाहरण
- GetRows
- इस उदाहरण में GetRows विधि का उपयोग करने के तरीके को दिखाया गया है
रिकॉर्डसेट ऑब्जेक्ट
एडीओ रिकॉर्डसेट ऑब्जेक्ट डाटाबेस तालिका से आए रिकॉर्डसेट को रखता है। एक रिकॉर्डसेट ऑब्जेक्ट रिकॉर्ड और स्तम्भ (क्षेत्र) से बना होता है
एडीओ में, यह ऑब्जेक्ट सबसे महत्वपूर्ण और सबसे अधिक प्रयोग होने वाला ऑब्जेक्ट है, जो डाटाबेस के डाटा के लिए ऑपरेशन करने के लिए प्रयोग किया जाता है
प्रोगआईडी
सेट ऑब्जेक्ट रिकॉर्डसेट = सर्वर.क्रिएटऑब्जेक्ट("ADODB.recordset")
जब आप पहली बार एक रिकॉर्डसेट खोलते हैं, तो वर्तमान रिकॉर्ड संकेतक पहले रिकॉर्ड की ओर जा जाता है, साथ ही BOF और EOF गुण फ़ॉल्सू रहते हैं। अगर कोई रिकॉर्ड नहीं है, तो BOF और EOF गुण फ़ॉल्सू रहते हैं
रिकॉर्डसेट ऑब्जेक्ट दो अपडेट प्रकारों को समर्थित करता है:
- तुरंत अपडेट - Update विधि को आमंत्रित करने के बाद, सभी परिवर्तन तुरंत डाटाबेस में लिखे जाते हैं
- बैच अपडेट - प्रोवाइडर कई परिवर्तनों को कैश में रखता है, और फिर उन परिवर्तनों को डाटाबेस में भेजने के लिए UpdateBatch विधि का उपयोग करता है
एडीओ द्वारा 4 अलग-अलग कुंजी (संकेतक) प्रकारों को परिभाषित किया गया है:
- डायनेमिक कुंजी - आपको अन्य उपयोगकर्ताओं द्वारा किए गए जोड़ने, परिवर्तन और अनुच्छेद को देखने की अनुमति है
- क्लास कुंजी गार - विशेषतः आपको अन्य उपयोगकर्ताओं द्वारा किए गए जोड़ने को देखने की क्षमता नहीं है, और यह आपको अन्य उपयोगकर्ताओं द्वारा अनुच्छेदित रिकॉर्ड की पहुंच को रोकेगा। अन्य उपयोगकर्ताओं द्वारा किए गए डाटा परिवर्तन अभी दृश्यमान हैं।
- स्थिर कर्सर - रिकॉर्डसेट की स्थिर प्रतिलिपि प्रदान करता है जो डाटा को खोजने या रिपोर्ट करने के लिए उपयोग की जा सकती है। इसके अलावा, अन्य उपयोगकर्ताओं द्वारा किए गए जोड़, संपादन और हटाने को देखा नहीं जा सकता है। जब आप एक क्लायंट रिकॉर्डसेट ऑब्जैक्ट खोलते हैं, तो यह एकमात्र अनुमति दिए गए कर्सर टाइप है।
- केवल आगे कर्सर - Recordset में केवल आगे गति की अनुमति देता है। इसके अलावा, अन्य उपयोगकर्ताओं द्वारा किए गए जोड़, संपादन और हटाने को देखा नहीं जा सकता है।
कर्सर टाइप के गुण या Open विधि में CursorType पैरामीटर के माध्यम से कर्सर के टाइप को सेट किया जा सकता है।
टिप्पणी:सभी प्रदाताओं (providers) रिकॉर्डसेट ऑब्जैक्ट के सभी विधि और गुणों को समर्थित नहीं करते।
गुण
| गुण | वर्णन |
|---|---|
| AbsolutePage | सेट या वापस करें एक मूल्य को जो रिकॉर्डसेट ऑब्जैक्ट में पृष्ठ संख्या को निर्दिष्ट करता है। |
| AbsolutePosition | सेट या वापस करें एक मूल्य को जो रिकॉर्डसेट ऑब्जैक्ट में वर्तमान रिकॉर्ड की क्रमिक स्थिति (सीजी) को निर्दिष्ट करता है। |
| ActiveCommand | रिकॉर्डसेट ऑब्जैक्ट से संबंधित कमांड ऑब्जैक्ट को वापस करें। |
| ActiveConnection | यदि कनेक्शन बंद है, कनेक्शन के निर्दिष्ट करें, अगर कनेक्शन खुला है, तो वर्तमान कनेक्शन ऑब्जैक्ट को सेट या वापस करें। |
| BOF | यदि वर्तमान रिकॉर्ड की स्थिति पहले के पहले रिकॉर्ड के बाद है, तो true वापस करें, अन्यथा false वापस करें। |
| Bookmark | सेट या वापस करें एक बुकमार्क को, जो वर्तमान रिकॉर्ड की स्थिति को सहेजता है। |
| CacheSize | सेट या वापस करें कैश की संख्या को जो शामिल किए जाने वाले रिकॉर्ड को। |
| CursorLocation | सेट या वापस करें कर्सर सेवा के स्थान को। |
| CursorType | सेट या वापस करें एक रिकॉर्डसेट ऑब्जैक्ट के कर्सर टाइप को। |
| DataMember | सेट या वापस करें डेटा सोर्स प्रॉपर्टी से संदर्भित ऑब्जैक्ट से रिक्त डेटा सदस्य के नाम को। |
| DataSource | एक ऑब्जैक्ट निर्दिष्ट करें जो रिकॉर्डसेट ऑब्जैक्ट के रूप में प्रस्तुत करने के लिए डाटा को शामिल करता है। |
| EditMode | वर्तमान रिकॉर्ड के संपादन स्थिति को वापस करें। |
| EOF | यदि वर्तमान रिकॉर्ड की स्थिति अंतिम रिकॉर्ड के बाद है, तो true वापस करें, अन्यथा false वापस करें। |
| 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 | ऑब्जेक्ट के आधार वाली क्वेरी को फिर से चलाकर Recordset ऑब्जेक्ट में डाटा को अद्यतन करने के लिए |
| Resync | आरंभिक डाटाबेस से वर्तमान Recordset में डाटा को नवीनतम रूप से ताज़ा करें。 |
| Save | Recordset ऑब्जेक्ट को file या Stream ऑब्जेक्ट में सहेजता है。 |
| Seek | Recordset के इंडेक्स को खोजता है ताकि निर्दिष्ट मूल्य के साथ मेल खाने वाली पंक्ति को त्वरित रूप से पाया जा सके और इसे वर्तमान पंक्ति के रूप में रखा जा सके。 |
| Supports | एक बूल वैल्यू वापस करता है, जो रिकॉर्डसेट ऑब्जेक्ट को किसी विशेष प्रकार की क्षमता के लिए समर्थन करता है को परिभाषित करता है。 |
| Update | सभी Recordset ऑब्जेक्ट के एक अकेले रिकॉर्ड पर किए गए संशोधनों को सहेजें。 |
| UpdateBatch | सभी Recordset में किए गए संशोधनों को डाटाबेस में भंडारित करें। बैच अपडेट मोड में इसका उपयोग करें。 |
इवेंट
नोट: आपको इवेंट्स को VBScript या JScript के द्वारा हैंडल नहीं कर सकते (केवल Visual Basic, Visual C++, और Visual J++ भाषाएँ इवेंट्स को हैंडल कर सकती हैं).
| इवेंट | वर्णन |
|---|---|
| EndOfRecordset | जब रिकॉर्डसेट के अंत के बाद की लाइन को जाने की कोशिश की जाए तो ट्रिगर होता है。 |
| FetchComplete | जब एसिंज़र ऑपरेशन में सभी रिकॉर्डों को पढ़ा गया हो तो ट्रिगर होता है。 |
| FetchProgress | एसिंज़र ऑपरेशन के दौरान नियमित रूप से ट्रिगर होता है, जो पढ़ा गया कितने रिकॉर्डों की सूचना देता है。 |
| FieldChangeComplete | Field ऑब्जेक्ट के मूल्य को बदलने के बाद ट्रिगर होता है。 |
| MoveComplete | जब Recordset में वर्तमान स्थान को बदलने के बाद ट्रिगर होता है。 |
| RecordChangeComplete | एक रिकॉर्ड को बदलने के बाद ट्रिगर होता है。 |
| RecordsetChangeComplete | जब Recordset को बदलने के बाद ट्रिगर होता है。 |
| WillChangeField | जब Field ऑब्जेक्ट के मूल्य को बदलने से पहले ट्रिगर होता है |
| WillChangeRecord | जब एक रिकॉर्ड को बदलने से पहले ट्रिगर होता है。 |
| WillChangeRecordset | जब Recordset को बदलने से पहले ट्रिगर होता है。 |
| WillMove | जब Recordset में वर्तमान स्थान को बदलने से पहले ट्रिगर होता है。 |
सेट
| सेट | वर्णन |
|---|---|
| Fields | यह Recordset ऑब्जेक्ट में Field ऑब्जेक्ट की संख्या को सूचित करता है。 |
| Properties | सभी Recordset ऑब्जेक्ट में Property ऑब्जेक्ट को शामिल करता है。 |
Fields संग्रह के गुण
| गुण | वर्णन |
|---|---|
| Count |
fields संग्रह में आइटम की संख्या को वापस करता है।0 से शुरू होता है。 उदाहरण: countfields = rs.Fields.Count |
| Item(named_item/number) |
fields संग्रह में किसी विशिष्ट आइटम को वापस करता है。 उदाहरण:
itemfields = rs.Fields.Item(1)
या
itemfields = rs.Fields.Item("Name")
|
Properties संग्रह के गुण
| गुण | वर्णन |
|---|---|
| Count |
properties संग्रह में आइटम की संख्या को वापस करता है।0 से शुरू होता है。 उदाहरण: countprop = rs.Properties.Count |
| Item(named_item/number) |
properties संग्रह में किसी विशिष्ट आइटम को वापस करता है。 उदाहरण:
itemprop = rs.Properties.Item(1)
या
itemprop = rs.Properties.Item("Name")
|
- पिछला पृष्ठ ADO Record
- अगला पृष्ठ ADO Stream
