OleDbEnumerator.GetRootEnumerator Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Retourneert een OleDbDataReader met informatie over de momenteel geïnstalleerde OLE DB-providers, zonder dat er een exemplaar van de OleDbEnumerator klasse nodig is.
public:
static System::Data::OleDb::OleDbDataReader ^ GetRootEnumerator();
public static System.Data.OleDb.OleDbDataReader GetRootEnumerator();
static member GetRootEnumerator : unit -> System.Data.OleDb.OleDbDataReader
Public Shared Function GetRootEnumerator () As OleDbDataReader
Retouren
Een OleDbDataReader met informatie over de zichtbare OLE DB-providers.
Uitzonderingen
De provider biedt geen ondersteuning voor ISourcesRowset.
Er is een uitzondering opgetreden in de onderliggende provider.
Voorbeelden
De volgende consoletoepassing haalt informatie op over alle zichtbare OLE DB-providers en geeft de informatie weer in het consolevenster.
Imports System.Data
Imports System.Data.OleDb
Module Module1
Sub Main()
Dim enumerator As New OleDbEnumerator
Dim reader As OleDbDataReader = OleDbEnumerator.GetRootEnumerator()
DisplayData(reader)
Console.WriteLine("Press any key to continue.")
Console.ReadKey()
End Sub
Private Sub DisplayData(ByVal reader As OleDbDataReader)
While reader.Read()
For i As Integer = 0 To reader.FieldCount - 1
Console.WriteLine("{0} = {1}", _
reader.GetName(i), reader.GetValue(i))
Next
Console.WriteLine("==================================")
End While
End Sub
End Module
using System;
using System.Data;
using System.Data.OleDb;
class Program
{
static void Main()
{
OleDbDataReader reader = OleDbEnumerator.GetRootEnumerator();
DisplayData(reader);
Console.WriteLine("Press any key to continue.");
Console.ReadKey();
}
static void DisplayData(OleDbDataReader reader)
{
while (reader.Read())
{
for (int i = 0; i < reader.FieldCount; i++)
{
Console.WriteLine("{0} = {1}",
reader.GetName(i), reader.GetValue(i));
}
Console.WriteLine("==================================");
}
}
}
Opmerkingen
De lezer die door deze methode wordt geretourneerd, bevat de volgende kolommen, die allemaal tekenreeksen bevatten:
| Kolomordinaal | Column | Description |
|---|---|---|
| 0 | SOURCES_NAME | De invariante naam van de systeemeigen OLEDB-gegevensbron of -opsomming. |
| 1 | SOURCES_PARSENAME | Een door mensen leesbare naam die kan worden geconverteerd naar een moniker met behulp van de systeemeigen COM-interface IParseDisplayName. Komt overeen met de SOURCES_PARSENAME kolom die wordt geretourneerd door de rijenset met systeemeigen OLE DB-bronnen. |
| 2 | SOURCES_DESCRIPTION | Beschrijving van de systeemeigen OLE DB-gegevensbron. Komt overeen met de SOURCES_DESCRIPTION kolom die wordt geretourneerd door de rijenset met systeemeigen OLE DB-bronnen. |
| 3 | SOURCES_TYPE | Een van de volgende opsommingsleden: Binder (0), DataSource_MDP (1), DataSource_TDP (2), Enumerator (3). Deze komen overeen met de waarden die worden geretourneerd in de kolom SOURCES_TYPE van de rijenset met systeemeigen OLE DB-bronnen. |
| 4 | SOURCES_ISPARENT | Alleen van toepassing op opsommingen. Als true, geeft aan dat de vermelding van toepassing is op dezelfde enumerator waarop GetSourcesRowset is aangeroepen, wat impliceert dat deze ook is opgenomen in de sub-opsomming. Komt overeen met de kolom SOURCES_ISPARENT van de systeemeigen OLE DB-bronnenrijset |
| 5 | SOURCES_CLSID | Een door mensen leesbare naam, die kan worden geconverteerd naar een moniker met behulp van de systeemeigen COM-interface IParseDisplayName. Komt overeen met de SOURCES_CLSID kolom die wordt geretourneerd door de rijenset met systeemeigen OLE DB-bronnen. |