Freigeben über


OleDbEnumerator.GetRootEnumerator Methode

Definition

Gibt einen OleDbDataReader zurück, der Informationen zu den aktuell installierten OLE DB-Anbietern enthält, ohne dass eine Instanz der OleDbEnumerator-Klasse erforderlich ist.

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

Gibt zurück

Ein OleDbDataReader-Objekt, das Informationen zu allen sichtbaren OLE DB-Anbietern enthält.

Ausnahmen

Der Anbieter unterstützt ISourcesRowset nicht.

Beim zugrunde liegenden Anbieter ist eine Ausnahme eingetreten.

Beispiele

Die folgende Konsolenanwendung ruft Informationen zu allen sichtbaren OLE DB-Anbietern ab und zeigt die Informationen im Konsolenfenster an.

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("==================================");  
   }  
 }  
}  

Hinweise

Der von dieser Methode zurückgegebene Reader enthält die folgenden Spalten, die alle Zeichenfolgen enthalten:

Column Ordinal Spalte BESCHREIBUNG
0 SOURCES_NAME Der invariante Name der nativen OLEDB-Datenquelle oder des Enumerators.
1 SOURCES_PARSENAME Ein für Menschen lesbarer Name, der mithilfe der nativen COM-Schnittstelle IParseDisplayName in einen Moniker konvertiert werden kann. Entspricht der SOURCES_PARSENAME Spalte, die vom rowset für native OLE DB-Quellen zurückgegeben wird.
2 SOURCES_DESCRIPTION Beschreibung der nativen OLE DB-Datenquelle. Entspricht der SOURCES_DESCRIPTION Spalte, die vom nativen OLE DB-Quellen-Rowset zurückgegeben wird.
3 SOURCES_TYPE Eines der folgenden Enumerationsmber: Binder (0), DataSource_MDP (1), DataSource_TDP (2), Enumerator (3). Diese entsprechen den Werten, die in der SOURCES_TYPE Spalte des nativen OLE DB-Quellenrowsets zurückgegeben werden.
4 SOURCES_ISPARENT Gilt nur für Enumeratoren. Wenn trueangibt, dass der Eintrag für den gleichen Enumerator gilt, für den GetSourcesRowset aufgerufen wurde, was impliziert, dass er auch in der Unteraufzählung enthalten ist. Entspricht der SOURCES_ISPARENT Spalte des Rowsets nativer OLE DB-Quellen
5 SOURCES_CLSID Ein für Menschen lesbarer Name, der mithilfe der nativen COM-Schnittstelle IParseDisplayName in einen Moniker konvertiert werden kann. Entspricht dem SOURCES_CLSID Spalte, die vom rowset für native OLE DB-Quellen zurückgegeben wird.

Gilt für: