Get Valid Recordset
Zuletzt geändert: 14.03.2026 05:56

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