OleDbEnumerator.GetRootEnumerator 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.
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
Uma OleDbDataReader que contém informações sobre os provedores OLE DB visíveis.
Exceções
O provedor não dá suporte a ISourcesRowset.
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. |