HasMultipleRecords, read-only

Beschreibung:

Gibt True zurück, wenn das RecordSet mehr als einen Datensatz beinhaltet. Diese Methode ist deutlich effizienter als die Abfrage von RecCount, insofern bei einem Filter genau ein Treffer erwartet wird, aber auch der Fall mit mehreren Treffern sauber behandelt werden soll.

Wichtig: Wird diese Eigenschaft direkt nach einer Filter-Methode aufgerufen, steht das RecordSet anschließend bereits auf dem ersten Datensatz. Wenn das Vorhandensein von Treffern anschließend über RecordSet.MoveNext geprüft wird, würde der erste Treffer dadurch übersprungen werden. Verwenden Sie daher die Eigenschaft besser erst, wenn Sie schon das Vorhandensein von Treffern abgeprüft haben. Das Überprüfen auf Treffer mittels RecordSet.MoveFirst würde immer funktionieren – es führt jedoch zu einer doppelten Datenbank-Operation.

Typ:

Bool

Beispiel VBScript:

If (oRecordSet.SetFilter...()) Then

    If (oRecordSet.MoveFirst()) Then

       If (oRecordSet.HasMultipleRecords = True) Then

           ' ... mehrere Treffer

       Else

           ' ... ein Treffer

       End If

    Else

       ' ... keine Treffer

    End If

Else

    ' ... Fehler

End If

Beispiel C#-Script:

RecordSet recordSet = cRM.CurrentProject.ViewConfigs.ItemByName("Kontakte").CreateRecordSet();

if (recordSet.SetFilterByName("ABC Kunden") == true)

{

    if (recordSet.MoveFirst() == true)

    {

        if (recordSet.HasMultipleRecords == true)

        {

            // ... mehrere Treffer

        }

        else

        {

            // ... ein Treffer

        }

    }

    else

    {

        // ... keine Treffer

    }

}

else

{

    // ... Fehler

}