Partilhar via


OleDbEnumerator.GetEnumerator(Type) Método

Definição

Usa um enumerador OLE DB específico para retornar um OleDbDataReader que contém informações sobre os provedores OLE DB instalados no momento, sem precisar de uma instância da classe OleDbEnumerator.

public:
 static System::Data::OleDb::OleDbDataReader ^ GetEnumerator(Type ^ type);
public static System.Data.OleDb.OleDbDataReader GetEnumerator (Type type);
static member GetEnumerator : Type -> System.Data.OleDb.OleDbDataReader
Public Shared Function GetEnumerator (type As Type) As OleDbDataReader

Parâmetros

type
Type

Uma Type.

Retornos

Um OleDbDataReader que contém informações sobre os provedores OLE DB solicitados, usando o enumerador OLE DB especificado.

Exceções

O provedor não dá suporte a ISourcesRowset.

Ocorreu uma exceção no provedor subjacente.

Exemplos

O aplicativo de console a seguir usa o componente MSDAENUM para recuperar informações sobre todos os provedores OLE DB 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.GetEnumerator(Type.GetTypeFromProgID("MSDAENUM"))  

    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.GetEnumerator(Type.GetTypeFromProgID("MSDAENUM"));  

   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 ou do enumerador OLE DB nativo.
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

O OLE DB fornece vários componentes de enumerador, incluindo MSDAENUM, Enumerador MSDASQL, Enumerador SQLNCLI, Enumerador SQLOLEDB e outros. Para obter mais informações sobre os componentes do enumerador e como usá-los, consulte a Referência do programador OLE DB.

Aplica-se a