OleDbEnumerator.GetEnumerator(Type) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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.OleDbDataReaderPublic Shared Function GetEnumerator (type As Type) As OleDbDataReaderParâmetros
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.
