OleDbEnumerator.GetEnumerator(Type) Método

Definição

Namespace:

System.Data.OleDb

Assembly:

System.Data.OleDb.dll

Pacote:

System.Data.OleDb v9.0.0-preview.3.24172.9

Origem:

OleDbEnumerator.cs

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

OleDbDataReader

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

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 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.