OleDbEnumerator.GetRootEnumerator Metodo

Definizione

Spazio dei nomi:

System.Data.OleDb

Assembly:

System.Data.OleDb.dll

Pacchetto:

System.Data.OleDb v9.0.0-rc.2.24473.5

Restituisce un oggetto OleDbDataReader contenente informazioni sui provider OLE DB attualmente installati senza dover ricorrere a un'istanza della 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

Restituisce

OleDbDataReader

OleDbDataReader contenente informazioni sui provider OLE DB visibili.

Eccezioni

InvalidCastException

Il provider non supporta ISourcesRowset.

OleDbException

È stata generata un'eccezione nel provider sottostante.

Esempio

L'applicazione console seguente recupera informazioni su tutti i provider OLE DB visibili e visualizza le informazioni nella finestra della 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("==================================");  
   }  
 }  
}  

Commenti

Il lettore restituito da questo metodo contiene le colonne seguenti, tutte contenenti stringhe:

Ordinale colonna	Colonna	Descrizione
0	SOURCES_NAME	Nome invariante dell'origine dati OLEDB nativa o dell'enumeratore.
1	SOURCES_PARSENAME	Nome leggibile che può essere convertito in un moniker usando l'interfaccia COM nativa IParseDisplayName. Corrisponde alla colonna SOURCES_PARSENAME restituita dal set di righe di origini OLE DB nativo.
2	SOURCES_DESCRIPTION	Descrizione dell'origine dati OLE DB nativa. Corrisponde alla colonna SOURCES_DESCRIPTION restituita dal set di righe di origini OLE DB nativo.
3	SOURCES_TYPE	Uno dei membri di enumerazione seguenti: Binder (0), DataSource_MDP (1), DataSource_TDP (2), Enumeratore (3). Questi corrispondono ai valori restituiti nella colonna SOURCES_TYPE del set di righe di origini OLE DB nativo.
4	SOURCES_ISPARENT	Applicabile solo agli enumeratori. Se true, indica che la voce si applica allo stesso enumeratore in cui è stato chiamato GetSourcesRowset, implicando che sia inclusa anche nell'enumerazione secondaria. Corrisponde alla colonna SOURCES_ISPARENT del set di righe di origini OLE DB native
5	SOURCES_CLSID	Nome leggibile che può essere convertito in un moniker usando l'interfaccia COM nativa IParseDisplayName. Corrisponde alla colonna SOURCES_CLSID restituita dal set di righe di origini OLE DB native.