OleDbEnumerator.GetRootEnumerator Método

Definição

Espaço de Nomes:
System.Data.OleDb
Assemblagem:
System.Data.dll

Devolve um OleDbDataReader que contém informação sobre os fornecedores de OLE DB atualmente instalados, sem exigir uma instância da OleDbEnumerator classe.

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

Devoluções

OleDbDataReader

A OleDbDataReader que contém informação sobre os fornecedores visíveis de OLE DB.

Exceções

InvalidCastException

O fornecedor não suporta o ISourcesRowset.

OleDbException

Houve exceção no fornecedor subjacente.

Exemplos

A aplicação de consola seguinte recupera informações sobre todos os fornecedores OLE DB visíveis e apresenta a informação na janela da consola.

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

Observações

O leitor devolvido por este método contém as seguintes colunas, todas contendo cadeias de caracteres:

Ordinal da coluna Coluna Description
0 SOURCES_NAME O nome invariante da fonte de dados ou enumerador OLEDB nativo.
1 SOURCES_PARSENAME Um nome legível por humanos que pode ser convertido para um nome usando a interface nativa COM IParseDisplayName. Corresponde à coluna SOURCES_PARSENAME devolvida pelo conjunto de linhas de fontes nativas do OLE DB.
2 SOURCES_DESCRIPTION Descrição da fonte de dados nativa OLE DB. Corresponde à coluna SOURCES_DESCRIPTION devolvida pelo conjunto de linhas de fontes nativas do OLE DB.
3 SOURCES_TYPE Um dos seguintes membros da enumeração: Fichário (0), DataSource_MDP (1), DataSource_TDP (2), Enumerador (3). Estes correspondem aos valores retornados na coluna SOURCES_TYPE do conjunto de linhas de fontes nativas do OLE DB.
4 SOURCES_ISPARENT Aplicável apenas a enumeradores. Se true, indica que a entrada se aplica ao mesmo enumerador no qual GetSourcesRowset foi chamado, implicando que também está incluído na subenumeração. Corresponde à coluna SOURCES_ISPARENT do conjunto de linhas de fontes nativas do OLE DB
5 SOURCES_CLSID Um nome legível por humanos, que pode ser convertido para um nome usando a interface COM nativa IParseDisplayName. Corresponde à coluna SOURCES_CLSID devolvida pelo conjunto de linhas de fontes nativas do OLE DB.

Aplica-se a