OleDbEnumerator.GetRootEnumerator Método

Definição

Namespace:

System.Data.OleDb

Assembly:

System.Data.OleDb.dll

Pacote:

System.Data.OleDb v9.0.0

Origem:

OleDbEnumerator.cs

Retorna um OleDbDataReader que contém informações sobre os provedores OLE DB atualmente instalados, sem precisar de uma instância da classe 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

Retornos

OleDbDataReader

Uma OleDbDataReader que contém informações sobre os provedores OLE DB visíveis.

Exceções

InvalidCastException

O provedor não dá suporte a ISourcesRowset.

OleDbException

Ocorreu uma exceção no provedor subjacente.

Exemplos

O aplicativo de console a seguir recupera informações sobre todos os provedores OLE DB visíveis e exibe as informações na janela do console.

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

Comentários

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

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