SQLResult  - AS3

Anger om alla resulterande data från en satskörning har returnerats.

Om en sats returnerar en eller flera rader anger den här egenskapen om samtliga rader har returnerats. Om execute()-metoden för ett SQLStatement-objekt anropas med ett prefetch-argumentvärde returneras endast det antal resulterande rader som har angetts i SQLResult-objektets egenskap data. Påföljande anrop till SQLStatement.next() gör ytterligare data tillgängliga. Den här egenskapen används för att avgöra när de sista resultaten har returnerats.

Observera att eftersom radantalet är okänt vid körningen måste databasmarkören placeras efter sista raden innan satskörningen kan betraktas som slutförd. När metoden SQLStatement.execute() anropas med ett prefetch-argument måste minst en rad utöver det totala antalet rader i resultatuppsättningen begäras innan den resulterande SQLResult-instansens complete-egenskap är true.

Relaterade API-element

Data som har returnerats som ett resultat av satskörningen, särskilt när en SQL SELECT-sats körs.

När en sats returnerar en eller flera rader är den här egenskapen en array som innehåller objekt som representerar resultatdataraderna. Varje objekt i arrayen har egenskapsnamn som motsvarar kolumnnamnen i resultatdatauppsättningen.

Anta till exempel att du kör följande SQL SELECT-sats:

     SELECT lastName, firstName
     FROM employees
     

Om tabellen employees innehåller 10 rader är egenskapen SQLResult.data en array med 10 element. Varje element är ett objekt med två egenskaper, lastName och firstName.

Situationen blir mer komplicerad när du använder en SELECT-sats med en komplex resultatkolumn, t.ex. en mängdfunktion. Anta till exempel att du kör följande SQL-sats:

     SELECT departmentId, SUM(salary)
     FROM employees
     GROUP BY departmentId
     

I resultatet av den här satsen har varje objekt i arrayen data två egenskaper som kallas departmentId och SUM(salary). "SUM(salary)" är dock inte en giltig identifierare. Om du använder en beräknad kolumn, t.ex. en mängdfunktion eller annan funktion, ska du ange ett alias för den beräknade kolumnen i SQL-satsen. Detta alias används som egenskapsnamnet i resultatdataobjekten. Överväg till exempel detta alternativ i stället för den föregående satsen:

     SELECT departmentId, SUM(salary) AS salarySubtotal
     FROM employees
     GROUP BY departmentId
     

I den här satsens data-array har resultatobjekten två egenskaper kallade departmentId och salarySubtotal.

Egenskapen data är alltid en array oavsett hur många rader och kolumner som finns i resultatuppsättningen. Följande SELECT-sats resulterar till exempel i en rad och en kolumn, vilket i grund och botten är ett enda värde:

     SELECT COUNT(*) AS numEmployees
     FROM employees
     

När frågan har körts innehåller egenskapen data ett array-objekt med ett element. Det elementet är ett objekt med en enda egenskap, numEmployees.

Om det finns duplicerade kolumnnamn i resulterande data, till exempel om SELECT-satsen innehåller två olika id-kolumner från två olika tabeller, tilldelas de duplicerade namnen egenskapsnamn beroende på värdet i egenskapen SQLConnection.columnNameStyle. Som standard används varje kolumnnamn som egenskapsnamn, men om det finns flera kolumner i resultatuppsättningen med samma namn används det långa namnformatet [table-name]_[column-name] för att identifiera kolumnerna. Detta kan ändras genom att du ställer in egenskapen SQLConnection.columnNameStyle.

Som standard är objekten i data-arrayen objektinstanser. Genom att ställa in värdet för egenskapen SQLStatement.itemClass på en klass kan elementen i data-arrayen skapas som instanser av den klassen i stället. För varje kolumn i resultatdatauppsättningen måste klassen itemClass ha en egenskap vars namn exakt motsvarar kolumnnamnet.

Om en sats inte returnerar några data är den här egenskapen null. Det är fallet om satsen inte är en SELECT-sats eller om den är en SELECT-sats som returnerar 0 rader.

Relaterade API-element

// Employee class definition
package
{
    public class Employee
    {
        public var name:String;
        public var ssn:String;
        public var id:uint;
        public override function toString():String
        {
            return "id: "+ id.toString() + " name: " + name + " ssn: " + ssn;
        }
    }
}


// using the Employee class as SQLStatement.itemClass
var conn:SQLConnection;
var dbStatement:SQLStatement;

function init():void
{
    conn = new SQLConnection();
    conn.addEventListener(SQLEvent.OPEN, connOpenHandler);
    
    dbStatement = new SQLStatement();
    dbStatement.sqlConnection = conn;
    dbStatement.text = "SELECT id, name, ssn FROM employees";
    dbStatement.itemClass = Employee;
    
    var dbFile:File = new File(File.separator + "employee.db");
    conn.open(dbFile);
}

function connOpenHandler(event:SQLEvent):void
{
    dbStatement.addEventListener(SQLEvent.RESULT, resultHandler);
    dbStatement.execute();
}

function resultHandler(event:SQLEvent):void
{
    var result:SQLResult = dbStatement.getResult();
    if (result != null)
    {
        var emp:Employee;
        var numRows:int = result.data.length;
        for (var i:int = 0; i < numRows; i++)
        {
            emp = result.data[i];
            trace(emp.toString());
        }
    }
}

Radidentifierare av senaste raden som har genererats av en SQL INSERT-sats.

Värdet är 0 om den körda satsen inte var någon INSERT-sats.

En radidentifierare används för att unikt identifiera en rad i tabellen inom databasen. Värdet genereras ofta av databasen.

Mer information om primära tangenter och skapade radidentifierare finns i avsnitten ”CREATE TABLE” och ”Uttryck” i bilagan ”SQL-stöd i lokala databaser”.

Relaterade API-element

Anger hur många rader som har påverkats av åtgärden. Endast ändringar som direkt anges av en INSERT-, UPDATE- eller DELETE-sats räknas.

Bidragande ändringar orsakade av utlösare räknas inte. Använd egenskapen SQLConnection.totalChanges om du vill få reda på det totala antalet ändringar inklusive ändringar orsakade av utlösare.

Observera att om den relaterade SQL-åtgärden är en DELETE-sats utan WHERE-sats (d.v.s. satsen raderar alla rader i tabellen), är egenskapen rowsAffected alltid 0, oavsett hur många rader som har raderats. För att ta reda på hur många rader som har raderats kan du inkludera WHERE-satsen WHERE 1 = 1. Då raderas alla rader och egenskapen rowsAffected uppger hur många rader som har raderats. Det här kan dock påverka satsens prestanda negativt beroende på antalet raderade rader.

Relaterade API-element

Skapar en SQLResult-instans. I allmänhet anropas SQLResult-konstruktorn direkt i koden. Om du vill hämta en SQLResult-instans som är associerad med en särskild SQLStatement-instans anropar du instansens getResult()-metod. En SQLResult-instans skickas också som ett argument till resultathanterarfunktionen när en Responder-instans har angetts för ett execute()- eller next()-metodanrop.