Esempi
GetRows
Questo esempio mostra come utilizzare il metodo GetRows.
oggetto Recordset
L'oggetto ADO Recordset è utilizzato per contenere una serie di record da una tabella del database. Un oggetto Recordset sono costituiti da record e le colonne (fields) .
In ADO, questo oggetto è il più importante e quello utilizzato più spesso per manipolare i dati da un database.
ProgID
set objRecordset=Server.CreateObject("ADODB.recordset")
Quando si apre un Recordset, il puntatore del record corrente punterà alla prima registrazione e la BOF e le proprietà EOF sono false. Se non ci sono record, il BOF e la proprietà EOF sono vere.
oggetti Recordset in grado di supportare due tipi di aggiornamento:
- Immediate updating - tutte le modifiche vengono scritte immediatamente nel database una volta che si chiama il metodo Update.
- Batch updating - il provider nella cache più modifiche e poi inviarli al database con il metodo UpdateBatch.
In ADO ci sono 4 diversi tipi di cursore definiti:
- Dynamic cursor - Permette di vedere le aggiunte, modifiche e cancellazioni da parte di altri utenti.
- Keyset cursor - Come un cursore dinamico, solo che non è possibile vedere le aggiunte da parte di altri utenti, e si impedisce l'accesso ai record che altri utenti hanno eliminati. le modifiche dei dati da parte di altri utenti saranno ancora visibili.
- Static cursor - Fornisce una copia statica di un set di record per l'utilizzo di trovare i dati o generare report. Aggiunte, modifiche o cancellazioni da parte di altri utenti non saranno visibili. Questo è l'unico tipo di cursore del permesso quando si apre un oggetto Recordset sul lato client.
- Forward-only cursor - Permette di scorrere solo in avanti attraverso il Recordset. Aggiunte, modifiche o cancellazioni da parte di altri utenti non saranno visibili.
Il tipo di cursore può essere impostato dalla proprietà CursorType o dal parametro CursorType nel metodo Open.
Note: Non tutti i provider supportano tutti i metodi o proprietà dell'oggetto Recordset.
Proprietà
| Proprietà | Descrizione |
|---|---|
| AbsolutePage | Imposta o restituisce un valore che specifica il numero di pagina nell'oggetto Recordset |
| AbsolutePosition | Imposta o restituisce un valore che specifica la posizione ordinale del record corrente nell'oggetto Recordset |
| ActiveCommand | Restituisce l'oggetto Command associata al Recordset |
| ActiveConnection | Imposta o restituisce una definizione per una connessione se la connessione viene chiusa, o l'oggetto Connection corrente se la connessione è aperta |
| BOF | Restituisce true se la posizione del record corrente è prima del primo record, altrimenti false |
| Bookmark | Imposta o restituisce un segnalibro. Il segnalibro salva la posizione del record corrente |
| CacheSize | Imposta o restituisce il numero di record che possono essere memorizzati nella cache |
| CursorLocation | Imposta o restituisce la posizione del servizio del cursore |
| CursorType | Imposta o restituisce il tipo di cursore di un oggetto Recordset |
| DataMember | Imposta o restituisce il nome del membro dati che verranno recuperate dall'oggetto a cui fa riferimento la proprietà DataSource |
| DataSource | Specifica un oggetto contenente dati di essere rappresentato come un oggetto Recordset |
| EditMode | Restituisce lo stato di modifica del record corrente |
| EOF | Restituisce true se la posizione del record corrente è dopo l'ultimo record, altrimenti false |
| Filter | Imposta o restituisce un filtro per i dati in un oggetto Recordset |
| Index | Imposta o restituisce il nome dell'indice corrente per un oggetto Recordset |
| LockType | Imposta o restituisce un valore che specifica il tipo di bloccaggio durante la modifica di un record in un Recordset |
| MarshalOptions | Imposta o restituisce un valore che specifica quali record devono essere restituiti al server |
| MaxRecords | Imposta o restituisce il numero massimo di record per tornare a un oggetto Recordset da una query |
| PageCount | Restituisce il numero di pagine con dati in un oggetto Recordset |
| PageSize | Imposta o restituisce il numero massimo di record consentiti in una singola pagina di un oggetto Recordset |
| RecordCount | Restituisce il numero di record in un oggetto Recordset |
| Sort | Imposta o restituisce i nomi campo del recordset per ordinare su |
| Source | Imposta un valore stringa o un riferimento oggetto Command, o restituisce un valore stringa che indica l'origine dati dell'oggetto Recordset |
| State | Restituisce un valore che descrive se l'oggetto Recordset è aperto, chiuso, collegamento, esecuzione o recupero dei dati |
| Status | Restituisce lo stato del record corrente per quanto riguarda gli aggiornamenti batch o altre operazioni di massa |
| StayInSync | Imposta o restituisce se il riferimento ai record figlio cambierà quando i cambiamenti di posizione record padre |
metodi
| Metodo | Descrizione |
|---|---|
| AddNew | Crea un nuovo record |
| Cancel | Annulla un'esecuzione |
| CancelBatch | Annulla un aggiornamento batch |
| CancelUpdate | Annulla le modifiche apportate ad un record di un oggetto Recordset |
| Clone | Crea un duplicato di un Recordset esistente |
| Close | Chiude un Recordset |
| CompareBookmarks | Confronta due segnalibri |
| Delete | Elimina un record o un gruppo di record |
| Find | Cercati un record in un Recordset che soddisfa criteri specificati |
| GetRows | Copie più record da un oggetto Recordset in una matrice bidimensionale |
| GetString | Restituisce un recordset come una stringa |
| Move | Sposta il puntatore del record in un oggetto Recordset |
| MoveFirst | Sposta il puntatore del record al primo record |
| MoveLast | Sposta il puntatore del record all'ultimo record |
| MoveNext | Sposta il puntatore del record al record successivo |
| MovePrevious | Sposta il puntatore del record al record precedente |
| NextRecordset | Cancella l'oggetto Recordset corrente e restituisce l'oggetto Recordset successivo ciclo attraverso una serie di comandi |
| Open | Apre un elemento di database che consente di accedere ai record in una tabella, i risultati di una query, o per un Recordset salvato |
| Requery | Aggiorna i dati in un recordset eseguendo nuovamente la query che ha fatto il Recordset originale |
| Resync | Aggiorna i dati della corrente Recordset dal database originale |
| Save | Salva un oggetto Recordset a un file o di un oggetto Stream |
| Seek | Cerchi l'indice di un recordset per trovare un record che corrisponde ai valori specificati |
| Supports | Restituisce un valore booleano che definisce se un oggetto Recordset supporta un tipo specifico di funzionalità |
| Update | Salva tutte le modifiche apportate a un singolo record in un oggetto Recordset |
| UpdateBatch | Salva tutti i cambiamenti in un Recordset al database. Utilizzato quando si lavora in modalità di aggiornamento batch |
eventi
Note: non è possibile gestire gli eventi utilizzando VBScript o JScript (solo Visual Basic, Visual C ++ e Visual J ++ lingue in grado di gestire gli eventi).
| Evento | Descrizione |
|---|---|
| EndOfRecordset | Attiva quando si tenta di spostare a un record dopo l'ultimo record |
| FetchComplete | Attivato dopo tutti i record in un'operazione asincrona sono stati recuperati |
| FetchProgress | Innescato periodicamente un'operazione asincrona, per indicare quanti record che sono stati scaricati |
| FieldChangeComplete | Attivato dopo il valore di un cambiamento oggetto Field |
| MoveComplete | Attivato dopo la posizione corrente nel Recordset è cambiato |
| RecordChangeComplete | Attivato dopo un record è stato modificato |
| RecordsetChangeComplete | Attivato dopo il Recordset è cambiato |
| WillChangeField | Innescato prima che il valore di un cambiamento oggetto Field |
| WillChangeRecord | Innescato prima di un cambiamento di registrazione |
| WillChangeRecordset | Innescato prima di un cambiamento Recordset |
| WillMove | Innescato prima della posizione corrente nei cambiamenti Recordset |
collezioni
| Collezione | Descrizione |
|---|---|
| Fields | Indica il numero di oggetti di campo nell'oggetto Recordset |
| Properties | Contiene tutti gli oggetti di proprietà nell'oggetto Recordset |
Proprietà di The Fields Collection
| Proprietà | Descrizione |
|---|---|
| Count | Restituisce il numero di elementi della collezione campi. Inizia a zero. Esempio: countfields = rs.Fields.Count |
| Item(named_item/number) | Restituisce un elemento specificato nella raccolta campi. Esempio: itemfields = rs.Fields. Item(1) |
Proprietà Le proprietà della Collezione
| Proprietà | Descrizione |
|---|---|
| Count | Restituisce il numero di elementi della collezione proprietà. Inizia a zero. Esempio: countprop = rs.Properties.Count |
| Item(named_item/number) | Restituisce un elemento specificato nella raccolta proprietà. Esempio: itemprop = rs.Properties. Item(1) |