Get-ValidRecordset

ÜBERSICHT

Liefert das erste geöffnete und gültige ADO-Recordset aus einer möglichen Recordset-Kette zurück.

SYNTAX

Get-ValidRecordset [[-Recordset] <System.__ComObject>] [<CommonParameters>]

BESCHREIBUNG

Diese Hilfsfunktion prüft, ob das übergebene `ADODB.Recordset` geöffnet ist. Wenn das Recordset geschlossen ist, wird rekursiv `.NextRecordset()` aufgerufen, bis entweder ein geöffnetes Recordset gefunden wird oder keine weiteren mehr existieren.

Wird ein geöffnetes Recordset gefunden, aber dieses ist leer, also `EOF = $true` ist, gibt die Funktion ebenfalls `$null` zurück.

PARAMETER

-Recordset

Type: System.__ComObject

Dieses kann z. B. aus einem `Execute`-Aufruf eines SQL-Statements stammen. Solche Aufrufe liefern gelegentlich mehrere Recordsets zurück, wobei das relevante Resultset nicht zwingend das erste sein muss.

AUSGABEN

System.__ComObject

Ein geöffnetes und nicht-leeres ADODB-Recordset oder `$null`.

BEISPIELE

# Gibt das erste nicht-leere und geöffnete Recordset aus einer Prozedur zurück.
$rs = $conn.Execute("EXEC MyProc")
$valideRs = Get-ValidRecordset $rs

HINWEISE

• Verwendet intern den ADO-Statuswert 1 (= adStateOpen), um gültige Recordsets zu erkennen.
• Wurde umbenannt und hieß ursprünglich `Get-AdoRs`