Поделиться через


OleDbEnumerator.GetRootEnumerator Метод

Определение

Возвращает объект OleDbDataReader, содержащий сведения об установленных в текущий момент поставщиках OLE DB, без требования экземпляра класса OleDbEnumerator.

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

Возвращаемое значение

Таблица OleDbDataReader, в которой содержатся сведения о видимых поставщиках OLE DB.

Исключения

Поставщик не поддерживает ISourcesRowset.

Исключение возникло у основного поставщика.

Примеры

Следующее консольное приложение извлекает сведения обо всех видимых поставщиках OLE DB и отображает их в окне консоли.

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

Комментарии

Средство чтения, возвращаемое этим методом, содержит следующие столбцы, все из которых содержат строки:

Порядковый номер столбца Столбец Описание
0 SOURCES_NAME Инвариантное имя собственного источника данных OLEDB или перечислителя.
1 SOURCES_PARSENAME Понятное имя, которое можно преобразовать в моникер с помощью собственного COM-интерфейса IParseDisplayName. Соответствует столбцу SOURCES_PARSENAME, возвращаемому собственным набором строк источников OLE DB.
2 SOURCES_DESCRIPTION Описание собственного источника данных OLE DB. Соответствует столбцу SOURCES_DESCRIPTION, возвращаемому собственным набором строк источников OLE DB.
3 SOURCES_TYPE Один из следующих элементов перечисления: связыватель (0), DataSource_MDP (1), DataSource_TDP (2), перечислитель (3). Они соответствуют значениям, возвращаемым в столбце SOURCES_TYPE набора строк собственного источника OLE DB.
4 SOURCES_ISPARENT Применимо только к перечислителям. Значение trueуказывает, что запись применяется к тому же перечислителю, для которого был вызван Метод GetSourcesRowset, что означает, что она также включена во вложенное перечисление. Соответствует столбцу SOURCES_ISPARENT набора строк собственного источника OLE DB.
5 SOURCES_CLSID Понятное имя, которое можно преобразовать в моникер с помощью собственного COM-интерфейса IParseDisplayName. Соответствует столбцу SOURCES_CLSID, возвращаемому собственным набором строк источников OLE DB.

Применяется к