Partilhar via

Coleções GetSchema e Schema

As classes Connection em cada um dos fornecedores geridos pelo .NET Framework implementam um método GetSchema que é usado para recuperar informações de esquema sobre a base de dados à qual está atualmente ligada. A informação do esquema devolvida pelo GetSchema método apresenta-se sob a forma de um DataTable. O método GetSchema é um método sobrecarregado que fornece os parâmetros opcionais para especificar a coleção de esquemas a retornar e para restringir a quantidade de informação retornada.

Especificando as coleções de esquema

O primeiro parâmetro opcional do GetSchema método é o nome da coleção, que é especificado como uma cadeia. Há dois tipos de coleções de esquema: coleções de esquema comuns que são comuns a todos os provedores e coleções de esquema específicas que são específicas para cada provedor.

Pode consultar um fornecedor gerido pelo .NET Framework para determinar a lista de coleções de esquemas suportadas chamando o GetSchema método sem argumentos, ou com o nome de coleção de esquemas "MetaDataCollections". Isso retornará uma DataTable com uma lista das coleções de esquema suportadas, o número de restrições que cada uma delas suporta e o número de partes de identificador que elas usam.

Exemplo de recuperação de coleções de esquema

Os exemplos seguintes demonstram como usar o GetSchema método do .NET Framework Data Provider para a classe SQL Server SqlConnection para recuperar informação de esquema de todas as tabelas contidas na AdventureWorks base de dados de exemplo:

Imports System.Data.SqlClient

Module Module1
   Sub Main()
      Dim connectionString As String = GetConnectionString()
      Using connection As New SqlConnection(connectionString)
         'Connect to the database then retrieve the schema information.
         connection.Open()
         Dim table As DataTable = connection.GetSchema("Tables")

         ' Display the contents of the table.
         DisplayData(table)
         Console.WriteLine("Press any key to continue.")
         Console.ReadKey()
      End Using
   End Sub

   Private Function GetConnectionString() As String
      ' To avoid storing the connection string in your code,
      ' you can retrieve it from a configuration file.
      Return "..."
   End Function

   Private Sub DisplayData(ByVal table As DataTable)
      For Each row As DataRow In table.Rows
         For Each col As DataColumn In table.Columns
            Console.WriteLine("{0} = {1}", col.ColumnName, row(col))
         Next
         Console.WriteLine("============================")
      Next
   End Sub
End Module

using System;
using System.Data;
using System.Data.SqlClient;

class Program
{
  static void Main()
  {
  string connectionString = GetConnectionString();
  using (SqlConnection connection = new SqlConnection(connectionString))
  {
   // Connect to the database then retrieve the schema information.
   connection.Open();
   DataTable table = connection.GetSchema("Tables");

   // Display the contents of the table.
   DisplayData(table);
   Console.WriteLine("Press any key to continue.");
   Console.ReadKey();
   }
 }

  private static string GetConnectionString()
  {
   // To avoid storing the connection string in your code,
   // you can retrieve it from a configuration file.
   return "...";
  }

  private static void DisplayData(System.Data.DataTable table)
  {
     foreach (System.Data.DataRow row in table.Rows)
     {
        foreach (System.Data.DataColumn col in table.Columns)
        {
           Console.WriteLine("{0} = {1}", col.ColumnName, row[col]);
        }
     Console.WriteLine("============================");
     }
  }
}

Consulte também

  • Last updated on