ADO Recordset 对象

Exempel

GetRows
Detta exempel visar hur man använder GetRows-metoden.

Recordset-objekt

ADO Recordset-objektet används för att innehålla en uppsättning poster från en databastabell. Ett Recordset-objekt består av poster och kolumner (fält).

I ADO är detta objekt det viktigaste och mest använda för att utföra dataoperationer på databasen.

ProgID

set objRecordset=Server.CreateObject("ADODB.recordset")

När du öppnar en Recordset för första gången pekar den aktuella postpekaren på den första posten, och BOF och EOF egenskaperna är False. Om det inte finns några poster är BOF och EOF egenskaperna True.

Recordset-objektet kan stödja två typer av uppdateringar:

  • Omedelbar uppdatering - alla ändringar skrivs omedelbart till databasen när Update-metoden anropas.
  • Batch-uppdatering - provider lagrar flera ändringar och skickar sedan dessa ändringar till databasen med UpdateBatch-metoden.

I ADO har 4 olika cursor (pekare) typer definierats:

  • Dynamisk cursor - tillåter dig att se tillägg, ändringar och raderingar som gjorts av andra användare
  • Nyckelset cursor - liknande dynamisk cursor, men du kan inte se tillägg som gjorts av andra användare, och det förhindrar dig från att komma åt poster som har tagits bort av andra användare. Dataändringar som gjorts av andra användare är fortfarande synliga.
  • Statisk cursor - Tillhandahåller en statisk kopia av datasetet, som kan användas för att söka data eller skapa rapporter. Dessutom är tillägg, ändringar och borttagningar gjorda av andra användare inte synliga. Detta är den enda tillåtna cursor typen när du öppnar en klient Recordset-objekt.
  • Endast framåt cursor - Tillåter endast att rulla framåt i Recordset. Dessutom är tillägg, ändringar och borttagningar gjorda av andra användare inte synliga.

Cursor typen kan ställas in via CursorType-egenskapen eller CursorType-parametern i Open-metoden.

Kommentar:Alla tillhandahållare (providers) stöder inte alla metoder och egenskaper för Recordset-objektet.

Egenskap

Egenskap Beskrivning
AbsolutePage Ställ in eller returnera ett värde som specificerar sidan för Recordset-objektet.
AbsolutePosition Ställ in eller returnera ett värde som specificerar den absoluta positionen för den aktuella posten i Recordset-objektet (sekventiell position).
ActiveCommand Returnerar Command-objektet som är associerat med Recordset-objektet.
ActiveConnection Ställ in eller returnera definitionen av anslutningen om anslutningen är stängd, om anslutningen är öppen, ställ in eller returnera det aktuella Connection-objektet.
BOF Returnerar true om den aktuella postens plats är innan den första posten, annars returneras false.
Bookmark Ställ in eller returnera en bokmärke. Bokmärket sparar platsen för den aktuella posten.
CacheSize Ställ in eller returnera antalet poster som kan cachas.
CursorLocation Ställ in eller returnera platsen för cursor tjänsten.
CursorType Ställ in eller returnera en cursor typ för Recordset-objektet.
DataMember Ställ in eller returnera namnet på datamember som ska hämtas från objektet som hänvisas till av DataSource-egenskapen.
DataSource Specificera ett objekt som innehåller data som ska representeras som Recordset-objekt.
EditMode Returnerar den aktuella redigeringsstatusen för posten.
EOF Returnerar true om den aktuella postens plats är efter det sista posten, annars returneras false.
Filter Returnera en filter som riktar sig till data i Recordset-objektet.
Index Ställ in eller returnera namnet på den aktuella indexen för Recordset-objektet.
LockType Ställ in eller returnera ett värde som specificerar vilken låstyp som kan användas när ett enskilt post i Recordset redigeras.
MarshalOptions Ställ in eller returnera ett värde som specificerar vilka poster som returneras till servern.
MaxRecords Ställ in eller returnera det maximala antalet poster som kan returneras från en fråga till ett Recordset-objekt.
PageCount Returnera antalet data sidor i ett Recordset-objekt.
PageSize Ställ in eller returnera det maximala antalet poster som tillåts på en enskild sida i Recordset-objektet.
RecordCount Returnera antalet poster i ett Recordset-objekt.
Sortera Ställ in eller returnera ett eller flera fältnamn som används som grunder för Recordset-sortering.
Source Ställ in en strängvärde, en Command-objektsreferens eller returnera en strängvärde som indikerar datakällan för Recordset-objektet.
State Returnera ett värde som beskriver om Recordset-objektet är öppet, stängt, ansluter, utför eller hämtar data.
Status Returnera statusen för aktuella posten för en batch-uppdatering eller andra omfattande operationer.
StayInSync Ställ in eller returnera om referensen till underposter ändras när föräldrapostens position ändras.

Metod

Metod Beskrivning
AddNew Skapa en ny post.
Cancel Ångra ett utförande.
CancelBatch Ångra en batch-uppdatering.
CancelUpdate Ångra ändringar på en post i Recordset-objektet.
Clone Skapa en kopia av ett befintligt Recordset.
Stäng Stäng ett Recordset.
CompareBookmarks Jämför två bokmärken.
Delete Ta bort en post eller en grupp av poster.
Find Sök en post i Recordset som uppfyller en specifik villkor.
GetRows Kopiera flera poster från ett Recordset-objekt till ett tvådimensionellt array.
GetString Returnera Recordset som en sträng.
Flytta Flytta inspelningspekaren i Recordset-objektet.
FlyttaFörsta Flytta inspelningspekaren till första posten.
FlyttaSista Flytta inspelningspekaren till sista posten.
FlyttaNästa Flytta inspelningspekaren till nästa post.
FlyttaFöregående Flytta inspelningspekaren till föregående post.
NästaRecordset Rensa aktuellt Recordset-objekt genom att utföra en serie kommandon och återgå till nästa Recordset.
Öppna Öppna ett databasobjekt, som kan tillhandahålla åtkomst till tabellens poster, sökresultat eller sparade Recordset.
Requery Uppdatera data i Recordset-objektet genom att återigen köra den fråga som objektet är baserat på.
Resync Uppdatera data i det aktuella Recordset från den ursprungliga databasen.
Save Spara Recordset-objektet till en fil eller Stream-objekt.
Seek Sök i indexet för Recordset för att snabbt lokalisera rader som matchar ett specifikt värde och gör dem till aktuella rader.
Supports Returnerar ett booleskt värde som definierar om Recordset-objektet stöder en specifik typ av funktion.
Update Spara alla ändringar som görs på ett enskilt record i Recordset-objektet.
UpdateBatch Spara alla ändringar i Recordset till databasen. Använd batch-uppdateringsläge.

Händelse

Anteckning: Du kan inte hantera händelser med VBScript eller JScript (endast Visual Basic, Visual C++ och Visual J++-språk kan hantera händelser).

Händelse Beskrivning
EndOfRecordset Uppkörs när försöket att flytta till en rad efter slutet av Recordset utförs.
FetchComplete Uppkörs när alla poster i en asynkron operation har lästs.
FetchProgress Uppkörs regelbundet under en asynkron operation, rapporterar hur många poster som har lästs.
FieldChangeComplete Uppkörs när värdet på Field-objektet ändras.
MoveComplete Uppkörs efter att positionen i Recordset har ändrats.
RecordChangeComplete Uppkörs efter att ett record har ändrats.
RecordsetChangeComplete Uppkörs efter att Recordset har ändrats.
WillChangeField Uppkörs innan värdet på Field-objektet ändras
WillChangeRecord Uppkörs innan ett record ändras.
WillChangeRecordset Uppkörs innan Recordset ändras.
WillMove Uppkörs innan positionen i Recordset ändras.

Samling

Samling Beskrivning
Fields Indikerar antalet Field-objekt i detta Recordset-objekt.
Properties Innehåller alla Property-objekt i alla Recordset-objekt.

Egenskaper för Fields-samlingen

Egenskap Beskrivning
Antal

Returnerar antalet objekt i fields-samlingen. Börjar vid 0.

Exempel:

	countfields = rs.Fields.Count
Item(named_item/number)

Returnerar en specifik post i fields-samlingen.

Exempel:

	itemfields = rs.Fields.Item(1)
	eller	
	itemfields = rs.Fields.Item("Name")

Egenskaper för Properties-samlingen

Egenskap Beskrivning
Antal

Returnerar antalet objekt i properties-samlingen. Börjar vid 0.

Exempel:

	countprop = rs.Properties.Count
Item(named_item/number)

Returnerar en specifik post i properties-samlingen.

Exempel:

	itemprop = rs.Properties.Item(1)
	eller
	itemprop = rs.Properties.Item("Name")