ADO-Recordset-Objekt
Beispiele
GetRows
Dieses Beispiel zeigt, wie Sie die GetRows Methode zu verwenden.
Cord-Objekt
ADO-Recordset-Objekt wird verwendet, um eine Gruppe von Datensätzen aus einer Datenbanktabelle zu halten. Ein Recordset-Objekt besteht aus Aufzeichnungen und Spalten (Felder) Komponenten.
In ADO ist dieses Objekt die wichtigsten und am häufigsten verwendeten Daten in den Datenbankobjekten verwendet zu bedienen.
ProgID
set objRecordset=Server.CreateObject("ADODB.recordset")
Wenn Sie zum ersten Mal ein Recordset öffnen, wird der aktuelle Datensatzzeiger auf den ersten Datensatz zeigen und BOF und EOF-Eigenschaft ist False. Wenn es keine Aufzeichnungen, BOF und EOF-Eigenschaft auf True.
Cord-Objekte können zwei Arten von Updates:
- Update - sobald Sie die Update-Methode aufrufen, werden alle Änderungen sofort in die Datenbank geschrieben. Batch-Update - Provider-Caches mehrere Änderungen vor, und verwenden Sie dann die Methode Update die Änderungen in der Datenbank zu übertragen.
In ADO definieren wir vier verschiedene Cursor (Zeiger) Typ:
- Dynamische Cursor - Hier können Sie anderen Benutzern zu sehen, hinzufügen, ändern und löschen
- Keysetcursor - ähnlich dynamische Cursor, mit der Ausnahme, dass Sie nicht andere Benutzer sehen können, die Sie hinzugefügt haben, und es wird verhindert, dass Sie einen anderen Benutzer gelöschte Datensätze zugreifen. Datenänderungen, die von anderen Benutzern sind noch sichtbar.
- Statische Cursor - Bietet eine statische Kopie eines Datensatzes verwendet werden können, Daten zu finden, oder Berichte zu erstellen. Zusätzlich kann durch die von anderen Benutzern, Änderung und Löschen wird nicht sichtbar sein. Wenn Sie eine clientseitige Recordset-Objekt, das die einzige Art von Cursor erlaubt ist.
- Nur vorwärts Cursor - erlauben nur nach vorne durch das Recordset blättern. Zusätzlich kann durch die von anderen Benutzern, Änderung und Löschen wird nicht sichtbar sein.
Cursor-Typ kann über die Eigenschaft Cursor oder Open-Methode Cursor Parameter eingestellt werden.
Hinweis: Nicht alle Anbieter (Provider) Unterstützung Cord - Objekts Methoden und Eigenschaften.
Immobilien
| Immobilien | Beschreibung |
|---|---|
| AbsolutePage | Setzt oder gibt einen Wert angegeben Objekt Recordset Seitenzahl. |
| AbsolutePosition | Setzt oder gibt einen Wert, Ordnungsposition angegeben werden kann (Ordnungsposition) -Recordset Objekts aktuellen Datensatz. |
| Active | Gibt Recordset-Objekt zugeordnet Befehlsobjekte. |
| ActiveConnection- | Wenn die Verbindung ausgeschaltet ist, oder kehren die Verbindung zu definieren, wenn die Verbindung geöffnet ist, setzt oder liefert die aktuelle Connection-Objekt. |
| BOF | Wenn die aktuelle Datensatzposition vor dem ersten Datensatz ist, gibt es wahr, sonst Fasle. |
| Lesezeichen | Setzt oder ein Lesezeichen zurückgibt. Lesezeichen dieser Standort den aktuellen Datensatz zu speichern. |
| CacheSize- | Setzt oder liefert die Anzahl der Datensätze, die im Cache gespeichert werden können. |
| Cursor | Setzt oder gibt die Position des Cursors Service. |
| Cursor | Setzt oder gibt den Cursor-Typ eines Recordset-Objekts. |
| Datamember | Setzt oder gibt den Namen des Objekts aus der referenzierten Eigenschaft Datasource abgerufenen Daten Mitglied. |
| Datasource | Gibt eine Datei mit dem Objekt als Daten Recordset-Objekt dargestellt werden. |
| EditMode | Zurück Status des aktuellen Datensatzes zu bearbeiten. |
| EOF | Wenn der aktuelle Datensatz nach dem letzten Datensatz, gibt es wahr, sonst Fasle. |
| Filter | Gibt ein Recordset-Objekt für den Datenfilter. |
| Index | Setzt oder gibt den Namen des aktuellen Recordset-Objekt-Index. |
| LockType | Setzt oder sendet Cord, wenn ein Datensatz bearbeiten, um den Wert des angegebenen Typs zu sperren. |
| Marshal | Setzt oder gibt einen Wert, der angibt, welche Datensätze an den Server zurückgegeben werden. |
| MaxRecords | Setzt oder sendet eine Abfrage, die ein Recordset-Objekt von der maximalen Anzahl der Datensätze zurückgibt. |
| Pagecount | Gibt ein Objekt Recordset Datenseiten. |
| Pagesize | Setzt oder gibt die maximale Anzahl der Datensätze auf einer einzigen Seite Recordset-Objekt ermöglicht. |
| Record | Gibt die Anzahl der Datensätze in einem Recordset-Objekt. |
| sortieren | Setzt oder sendet ein oder mehrere Referenz als Recordset sortieren Feldnamen. |
| Quelle | einen String-Wert oder ein Command-Objekt Referenz-Einstellung, oder es wird ein String, der die Datenquelle Recordset-Objekt anzeigen. |
| Zustand | Es gibt einen Wert zurück, die beschreiben kann, ob das Recordset-Objekt geöffnet ist, geschlossen, Verbinden, im Gange oder Daten abzurufen. |
| Status | Zurück Batch-Updates oder andere auf den Status des aktuellen Datensatzes im Zusammenhang mit Bulk-Operationen. |
| StayInSync | Setzt oder sendet, wenn das Paar aufgezeichnet, wenn der übergeordnete Datensatz Position ändert Referenz geändert wird. |
Weg
| Weg | Beschreibung |
|---|---|
| NeuHinzufüg | Erstellen Sie einen neuen Rekord. |
| stornieren | Rückgängigmachen der letzten Ausführung. |
| CancelBatch | Lösen Sie die letzte Partie Update. |
| CancelUpdate | Die Rücknahme eines Recordset-Objekts ändert. |
| Klon | Erstellen Sie eine Kopie eines bestehenden Cord. |
| schließen | Schließen eines Recordset. |
| CompareBookmarks | Vergleicht zwei Lesezeichen. |
| löschen | Datensatz löschen oder eine Gruppe von Datensätzen. |
| finden | Suchen Sie ein Recordset, die eine Bedingung in einem Datensatz angegeben erfüllt. |
| GetRows | Mehrere Kopien der Datensätze von einem Re-Cord-Objekt in ein zweidimensionales Array. |
| GetString | Das Recordset wird als String zurückgegeben. |
| Umzug | Im Recordset-Objekt, um den Datensatzzeiger bewegen. |
| Movefirst | Der Datensatzzeiger auf den ersten Datensatz. |
| Movelast | Der Datensatzzeiger auf den letzten Datensatz. |
| Movenext | Der Datensatzzeiger bewegt sich auf den nächsten Datensatz. |
| MovePrevious | Bewegen Sie den Datensatzzeiger auf den vorhergehenden Datensatz. |
| NextRecordset | Löscht den aktuellen Recordset-Objekt durch eine Reihe von Befehlen ausgeführt wird und gibt den nächsten Cord. |
| geöffnet | Öffnen Sie eine Datenbank-Element, das eine Aufzeichnung der Tabelle enthält die Ergebnisse einer Abfrage oder gespeicherten Datensatzzugriff. |
| Requery | So aktualisieren Sie die Daten in einem Recordset-Objekt durch erneutes Ausführen objektbasierte Abfrage. |
| Resync | Aktualisieren Sie die Daten im aktuellen Recordset aus der ursprünglichen Datenbank. |
| Speichern | Cord-Objekt die Datei oder das Stream-Objekt zu speichern. |
| suchen | Cord-Index-Suche, um schnell den angegebenen Wert lokalisieren entspricht der Linie und macht es die aktuelle Zeile. |
| Unterstützt | Es gibt einen Booleschen Wert, die definieren, ob ein Recordset-Objekt eine bestimmte Art von Funktionalität unterstützt. |
| Aktualisierung | Speichern Sie alle Änderungen, die an einem einzelnen Datensatz in dem Re-Cord-Objekt. |
| Update | Alle Datensatzänderungen in der Datenbank gespeichert. Verwenden Sie im Batch-Update-Modus. |
Ereignis
Hinweis: Sie können VBScript oder JScript Prozess verwenden (erlaubt nur Visual Basic, Visual C ++ und Visual J ++ Sprachverarbeitung Ereignisse).
| Ereignis | Beschreibung |
|---|---|
| EndOfRecordset | Wenn Sie versuchen, über das Ende der Cord-Reihe zu bewegen ausgelöst. |
| FetchComplete | Wenn die asynchrone Operation ausgelöst, nachdem alle Datensätze gelesen werden. |
| FetchProgress | Werden in regelmäßigen Abständen während einer asynchronen Operation ausgelöst, berichtet er, wie viele Datensätze gelesen wurden. |
| Fieldchangecomplete | Ändern Sie den Wert eines Field-Objekts ausgelöst wird. |
| Movecomplete | Recordset die aktuellen Positionsänderungen nach dem Trigger. |
| RecordChangeComplete | Nach einer Aufnahme wird Änderung ausgelöst. |
| RecordsetChangeComplete | Es ist nach dem Re-Cord Veränderungen ausgelöst. |
| Willchangefield | Feld ausgelöst werden, bevor der Wert des Objekts ändert |
| Willchangerecord | Es wird vor einem Satzwechsel ausgelöst. |
| WillChangeRecordset | Es wird vor dem Re-Cord Veränderungen ausgelöst. |
| Willmove | Cord ist vor dem aktuellen Positionsänderungen ausgelöst. |
Set
| Set | Beschreibung |
|---|---|
| Felder | Sie gibt die Anzahl dieses Objekt Recordset Field-Objekt. |
| Eigenschaften | Er enthält alle Recordset-Objekt Property-Objekt. |
Eigenschaftsfelder Sammlung
| Immobilien | Beschreibung |
|---|---|
| Graf | Gibt die Anzahl der Felder in der Sammlung von Gegenständen. Beginnt bei Null. Beispiele: countfields = rs.Fields.Count |
| Artikel (named_item / Nummer) | Gibt Felder in der Sammlung eines angegebenen Elements. Beispiele: itemfields = rs.Fields.Item(1) 或者 itemfields = rs.Fields.Item("Name") |
Eigenschaften Eigenschaften Sammlung
| Immobilien | Beschreibung |
|---|---|
| Graf | Gibt die Anzahl der Elemente in einer Auflistung von Eigenschaften. Beginnt bei Null. Beispiele: countprop = rs.Properties.Count |
| Artikel (named_item / Nummer) | Gibt die Eigenschaften eines bestimmten Elements in der Sammlung. Beispiele: itemprop = rs.Properties.Item(1) 或者 itemprop = rs.Properties.Item("Name") |