Beispiele
GetRows
Dieses Beispiel zeigt, wie Sie die GetRows Methode verwenden.
Cord-Objekt
Das ADO-Recordset-Objekt wird verwendet, um eine Gruppe von Datensätzen aus einer Datenbanktabelle zu halten. Ein Datensatz Objekt besteht aus Datensatz und Spalten (fields) .
In ADO ist dieses Objekt das wichtigste und die am häufigsten verwendet, um Daten aus einer Datenbank zu manipulieren.
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 die BOF und EOF Eigenschaften sind falsch. Wenn es keine Aufzeichnungen gibt, sind die BOF und EOF-Eigenschaft True fest.
Cord-Objekte können zwei Arten von Aktualisierungen unterstützen:
- Immediate updating - alle Änderungen werden sofort in die Datenbank geschrieben , wenn Sie die Update - Methode aufrufen.
- Batch updating - der Anbieter mehr Änderungen zwischenspeichern und sie dann mit der Methode Update an die Datenbank senden.
In ADO gibt es 4 verschiedene Cursortypen definiert:
- Dynamic cursor - Hier können Sie Ergänzungen, Änderungen sehen, und Löschungen von anderen Benutzern.
- Keyset cursor - Wie ein dynamischer Cursor, mit der Ausnahme , dass Sie nicht Ergänzungen durch andere Benutzer sehen können, und es verhindert den Zugriff auf Datensätze , die anderen Benutzern gelöscht haben. Datenänderungen durch andere Benutzer immer noch sichtbar sein.
- Static cursor - Bietet eine statische Kopie eines Datensatzes für Sie Daten zu verwenden , um Berichte zu finden oder zu erzeugen. Ergänzungen, Änderungen oder Streichungen von anderen Benutzern nicht sichtbar sein wird. Dies ist die einzige Art von Cursor erlaubt, wenn Sie ein clientseitige Recordset-Objekt öffnen.
- Forward-only cursor - Hier können Sie nur nach vorne durch die Re - Cord - blättern. Ergänzungen, Änderungen oder Streichungen von anderen Benutzern nicht sichtbar sein wird.
Der Cursor-Typ kann durch die Eigenschaft Cursor oder durch die Cursor Parameter in der Open-Methode festgelegt werden.
Note: Nicht alle Provider unterstützen alle Methoden oder Eigenschaften des Recordset - Objekts.
Eigenschaften
| Eigentum | Beschreibung |
|---|---|
| AbsolutePage | Setzt oder gibt einen Wert, der die Seitennummer in dem Re-Cord-Objekt gibt |
| AbsolutePosition | Setzt oder gibt einen Wert, der die Ordinalposition des aktuellen Datensatz in dem Cord-Objekt angibt |
| ActiveCommand | Gibt das Command-Objekt mit dem Re-Cord zugeordnet |
| ActiveConnection | Setzt oder gibt eine Definition für eine Verbindung, wenn die Verbindung geschlossen ist oder das aktuelle Connection-Objekt, wenn die Verbindung geöffnet ist |
| BOF | Gibt true zurück, wenn die aktuelle Datensatz Position vor dem ersten Datensatz ist, andernfalls false |
| Bookmark | Setzt oder ein Lesezeichen zurückgibt. Das Lesezeichen speichert die Position des aktuellen Datensatzes |
| CacheSize | Setzt oder gibt die Anzahl der Datensätze, die im Cache gespeichert werden können |
| CursorLocation | Setzt oder gibt die Position des Cursors Service |
| CursorType | Sets oder gibt den Cursortyp eines Cord-Objekt |
| DataMember | Setzt oder gibt den Namen des Datenelementes, das von dem Objekt abgerufen wird von der Datasource-Eigenschaft verwiesen |
| DataSource | Gibt ein Objektdaten enthält, als Cord-Objekt dargestellt werden, |
| EditMode | Gibt den Bearbeitungsstatus des aktuellen Datensatzes |
| EOF | Gibt true zurück, wenn die aktuelle Datensatz Position nach dem letzten Datensatz ist, andernfalls false |
| Filter | Setzt oder sendet einen Filter für die Daten in einem Objekt-Cord |
| Index | Setzt oder gibt den Namen des aktuellen Index für ein Re-Cord-Objekt |
| LockType | Setzt oder gibt einen Wert, der die Art der Verriegelung angibt, wenn die Bearbeitung eines Datensatzes in einer Datensatzgruppe |
| MarshalOptions | Setzt oder gibt einen Wert zurück, der angibt, welche Datensätze an den Server zurückzusenden sind |
| MaxRecords | Setzt oder gibt die maximale Anzahl der Datensätze zu einem Re-Cord-Objekt zurückgeben aus einer Abfrage |
| PageCount | Gibt die Anzahl der Seiten mit Daten in einem Re-Cord-Objekt |
| PageSize | Setzt oder gibt die maximale Anzahl der Datensätze auf einer einzelnen Seite eines Recordset-Objekts erlaubt |
| RecordCount | Gibt die Anzahl der Datensätze in einem Recordset-Objekt |
| Sort | Setzt oder liefert die Feldnamen in der Recordset zu sortieren |
| Source | Setzt einen Stringwert oder einen Befehl Objektreferenz, oder es wird ein String, der die Datenquelle des Cord-Objekt zeigt |
| State | Gibt einen Wert, der beschreibt, wenn das Cord-Objekt geöffnet ist, geschlossen ist, verbindet, die Ausführung oder das Abrufen von Daten |
| Status | Gibt den Status des aktuellen Datensatzes im Hinblick auf die Batch-Updates oder andere Bulk-Operationen |
| StayInSync | Setzt oder gibt zurück, ob der Verweis auf die untergeordneten Datensätze wird, wenn die Position übergeordneten Datensatz Änderungen ändern |
Methods
| Methode | Beschreibung |
|---|---|
| AddNew | Erstellt einen neuen Rekord |
| Cancel | Bricht eine Ausführung |
| CancelBatch | Bricht eine Batch-Update |
| CancelUpdate | Bricht Änderungen an einem Datensatz eines Recordset-Objekt |
| Clone | Erstellt ein Duplikat eines vorhandenen Recordset |
| Close | Schließt Cord |
| CompareBookmarks | Vergleicht zwei Lesezeichen |
| Delete | Löscht einen Datensatz oder eine Gruppe von Datensätzen |
| Find | Suchen nach einem Datensatz in einem Re-Cord, die ein bestimmten Kriterien erfüllt |
| GetRows | Kopien mehrerer Datensätze aus einem Cord-Objekts in ein zweidimensionales Array |
| GetString | Gibt einen Recordset als String |
| Move | Bewegt den Datensatzzeiger in einem Objekt-Cord |
| MoveFirst | Bewegt den Datensatzzeiger auf den ersten Datensatz |
| MoveLast | Bewegt den Datensatzzeiger auf den letzten Datensatz |
| MoveNext | Bewegt den Datensatzzeiger auf den nächsten Datensatz |
| MovePrevious | Bewegt den Datensatzzeiger auf den vorherigen Datensatz |
| NextRecordset | Löscht das aktuelle Datensatzgruppe Objekt und gibt das nächste Cord-Objekt, indem er durch eine Reihe von Befehlen Looping |
| Open | Öffnet ein Datenbank-Element, das Sie den Zugriff auf Datensätze in einer Tabelle, die Ergebnisse einer Abfrage gibt, oder zu einem gespeicherten Recordset |
| Requery | Aktualisiert die Daten in einem Re-Cord durch die Abfrage erneut ausgeführt werden, die den Original-Cord gemacht |
| Resync | Aktualisiert die Daten im aktuellen Recordset aus der ursprünglichen Datenbank |
| Save | Speichert ein Objekt Recordset in einer Datei oder einem Stream-Objekt |
| Seek | Sucht den Index eines Recordset einen Datensatz zu finden, die den angegebenen Werten entspricht |
| Supports | Gibt einen booleschen Wert, der definiert, ob ein Objekt-Cord eine spezifische Art von Funktionalität unterstützt |
| Update | Speichert alle zu einem einzigen Datensatz vorgenommenen Änderungen in einem Re-Cord-Objekt |
| UpdateBatch | Speichert alle Änderungen in einem Re-Cord in die Datenbank. Wird verwendet, wenn im Batch-Update-Modus arbeiten |
Veranstaltungen
Note: Sie können keine Ereignisse mit VBScript oder JScript (nur Visual Basic, Visual C ++ und Visual J ++ Sprachen können Ereignisse behandeln) verarbeiten kann.
| Event | Beschreibung |
|---|---|
| EndOfRecordset | Ausgelöst, wenn Sie versuchen, auf einen Datensatz nach dem letzten Datensatz zu bewegen |
| FetchComplete | Ausgelöst, nachdem alle Datensätze in einer asynchronen Operation abgerufen wurden |
| FetchProgress | Ausgelöst periodisch in einem asynchronen Betrieb zu erklären, wie viele weitere Datensätze, die abgerufen worden ist |
| Fieldchangecomplete | Ausgelöst nach dem Wert einer Feldobjektänderung |
| Movecomplete | Ausgelöst, nachdem die aktuelle Position in dem Re-Cord hat sich geändert |
| RecordChangeComplete | Ausgelöst, nachdem ein Datensatz geändert hat |
| RecordsetChangeComplete | Ausgelöst, nachdem das Re-Cord hat sich geändert |
| Willchangefield | Ausgelöst vor dem Wert eines Feldobjekt ändern |
| Willchangerecord | Ausgelöst vor einem Satzwechsel |
| WillChangeRecordset | Ausgelöst vor einer Cord-Änderung |
| Wird sich bewegen | Ausgelöst vor der aktuellen Position in den Datensatzänderungen |
Sammlungen
| Sammlung | Beschreibung |
|---|---|
| Fields | Gibt die Anzahl der Feldobjekte in dem Re-Cord-Objekt |
| Properties | Enthält alle Immobilien-Objekte in dem Re-Cord-Objekt |
Die Felder Collection Properties
| Eigentum | Beschreibung |
|---|---|
| Count | Gibt die Anzahl der Elemente in den Bereichen Sammlung. Beginnt bei Null. Beispiel: countfields = rs.Fields.Count |
| Item(named_item/number) | Gibt ein bestimmtes Element in der Felder-Sammlung. Beispiel: itemfields = rs.Fields. Item(1) |
Die Eigenschaften Collection Properties
| Eigentum | Beschreibung |
|---|---|
| Count | Gibt die Anzahl der Elemente in der Immobilien-Sammlung. Beginnt bei Null. Beispiel: countprop = rs.Properties.Count |
| Item(named_item/number) | Gibt ein bestimmtes Element in der Eigenschaften-Sammlung. Beispiel: itemprop = rs.Properties. Item(1) |