Restrições de esquema

Aplica-se a: .NET Framework .NET .NET Standard

O segundo parâmetro opcional do método GetSchema são as restrições usadas para limitar a quantidade de informação do esquema devolvida, e este é passado para o método GetSchema como um array de cadeias. A posição na matriz determina os valores que você pode passar, e isso é equivalente ao número de restrição.

Por exemplo, a tabela seguinte descreve as restrições suportadas pela coleção de esquemas "Tables" usando o Microsoft SqlClient Data Provider for SQL Server. Restrições adicionais para coleções de esquemas do SQL Server estão listadas no final deste tópico.

Nome da restrição	Nome do parâmetro	Padrão de restrição	Número de restrição
Catalog	@Catalog	TABLE_CATALOG	1
Proprietário	@Owner	ESQUEMA_DA_TABELA	2
Table	@Name	NOME_DA_TABELA	3
Tipo de tabela	@TableType	TABLE_TYPE	4

Especificação dos valores de restrição

Para usar uma das restrições da coleção de esquema "Tables", basta criar uma matriz de cadeias de caracteres com quatro elementos e, em seguida, colocar um valor no elemento que corresponda ao número de restrição. Por exemplo, para restringir as tabelas devolvidas pelo método GetSchema apenas às tabelas do esquema "Sales", defina o segundo elemento do array como "Sales" antes de o passar para o método GetSchema .

Observação

As coleções de restrições para SqlClient têm uma coluna adicional ParameterName . A coluna padrão de restrição ainda está lá para compatibilidade com versões anteriores, mas é ignorada no momento. Devem ser usadas consultas parametrizadas em vez de substituição de strings para minimizar o risco de um ataque de injeção SQL ao especificar valores de restrição.
O número de elementos na matriz deve ser menor ou igual ao número de restrições suportadas para a coleção de esquema especificada, caso contrário, um ArgumentException será lançado. Pode haver menos do que o número máximo de restrições. As restrições em falta são consideradas nulas (sem restrições).

Pode consultar o Microsoft SqlClient Data Provider para SQL Server para determinar a lista de restrições suportadas, chamando o método GetSchema com o nome da coleção de esquemas de restrições, que é "Restrictions". Isso retornará um DataTable com uma lista dos nomes de coleção, os nomes de restrição, os valores de restrição padrão e os números de restrição.

Example

Os exemplos seguintes demonstram como usar o GetSchema método da classe Microsoft SqlClient Data Provider for SQL Server SqlConnection para recuperar informações de esquema sobre todas as tabelas contidas na base de dados de exemplo AdventureWorks , e restringir a informação devolvida apenas às tabelas do esquema "Sales":

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

class Program
{
    static void Main(string[] args)
    {
        string connectionString = "Data Source = localhost; Integrated Security = true; Initial Catalog = AdventureWorks";
        
        using (SqlConnection connection = new SqlConnection(connectionString))
        {
            connection.Open();

            // Specify the restrictions.  
            string[] restrictions = new string[4];
            restrictions[1] = "Sales";
            System.Data.DataTable table = connection.GetSchema("Tables", restrictions);

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

    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("============================");
        }
    }
}