OleDbEnumerator.GetRootEnumerator Methode

Definition

Namespace:

System.Data.OleDb

Assembly:

System.Data.OleDb.dll

Paket:

System.Data.OleDb v9.0.0-rc.2.24473.5

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

OleDbDataReader

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

Ausnahmen

InvalidCastException

Der Anbieter unterstützt ISourcesRowset nicht.

OleDbException

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.