DbDataAdapter.FillSchema Método

protected:
 virtual cli::array <System::Data::DataTable ^> ^ FillSchema(System::Data::DataSet ^ dataSet, System::Data::SchemaType schemaType, System::Data::IDbCommand ^ command, System::String ^ srcTable, System::Data::CommandBehavior behavior);

protected virtual System.Data.DataTable[] FillSchema(System.Data.DataSet dataSet, System.Data.SchemaType schemaType, System.Data.IDbCommand command, string srcTable, System.Data.CommandBehavior behavior);

override this.FillSchema : System.Data.DataSet * System.Data.SchemaType * System.Data.IDbCommand * string * System.Data.CommandBehavior -> System.Data.DataTable[]

Protected Overridable Function FillSchema (dataSet As DataSet, schemaType As SchemaType, command As IDbCommand, srcTable As String, behavior As CommandBehavior) As DataTable()

Parâmetros

Devoluções

Um array de DataTable objetos que contêm informação do esquema devolvida da fonte de dados.

Observações

O FillSchema método recupera o esquema da fonte de dados usando o SelectCommand. O objeto de ligação associado ao SelectCommand deve ser válido, mas não precisa de ser aberto. Se a ligação for fechada antes FillSchema de ser chamada, é aberta para recuperar dados e depois fechada. Se a ligação estiver aberta antes FillSchema de ser chamada, permanece aberta.

Uma FillSchema operação adiciona a DataTable ao destino DataSet. Depois, adiciona colunas ao DataColumnCollection de DataTable, e configura as seguintes DataColumn propriedades se existirem na fonte de dados:

• AllowDBNull

• AutoIncrement. Deves definir AutoIncrementStep e AutoIncrementSeed separadamente.

• MaxLength

• ReadOnly

• Unique

FillSchema também configura as PrimaryKey propriedades e Constraints de acordo com as seguintes regras:

• Se uma ou mais colunas de chave primárias forem devolvidas pelo SelectCommand, elas são usadas como colunas de chave primárias para o DataTable.

• Se não forem devolvidas colunas de chave primárias mas colunas únicas forem, as colunas únicas são usadas como chave primária se, e só se, todas as colunas únicas forem não anuláveis. Se alguma das colunas for anulável, a UniqueConstraint é adicionado ao ConstraintCollection, mas a PrimaryKey propriedade não é definida.

• Se forem retornadas tanto as colunas chave primárias como as colunas únicas, as colunas principais primárias são usadas como as colunas principais primárias para o DataTable.

Note-se que as chaves primárias e as restrições únicas são adicionadas ao ConstraintCollection de acordo com as regras anteriores, mas outros tipos de restrições não são adicionados.

Se um único índice clusterizado for definido numa coluna ou colunas numa tabela SQL Server e a restrição principal da chave for definida num conjunto separado de colunas, então os nomes das colunas no índice clusterizado serão devolvidos. Para devolver o nome ou nomes das colunas de chave primária, use uma dica de consulta com a instrução SELECT que especifica o nome do índice de chave primária. Para mais informações sobre especificação de dicas de consulta, veja Dicas (Transact-SQL) - Consulta.

Se encontrar IDataAdapter colunas duplicadas ao preencher um DataTable, gera nomes para as colunas seguintes, usando o padrão "nome da coluna1", "nome da coluna2", "nome da coluna3", e assim sucessivamente. Se os dados recebidos contêm colunas sem nome, são colocadas segundo DataSet o padrão "Coluna 1", "Coluna 2", e assim sucessivamente. Quando vários conjuntos de resultados são adicionados, DataSet cada conjunto de resultados é colocado numa tabela separada. Conjuntos de resultados adicionais são nomeados adicionando valores integrais ao nome da tabela especificado (por exemplo, "Table", "Table1", "Table2", entre outros). Se a sua aplicação usar nomes de colunas e tabelas, certifique-se de que não há conflitos com esses padrões de nomenclatura.

O FillSchema método suporta cenários em que contém DataSet múltiplos DataTable objetos cujos nomes diferem apenas consoante o caso. Nessas situações, FillSchema realiza uma comparação sensível a maiúsculos e minúsculos para encontrar a tabela correspondente, criando uma nova tabela se não existir correspondência exata. O seguinte código C# ilustra este comportamento.

DataSet dataset = new DataSet();
dataset.Tables.Add("aaa");
dataset.Tables.Add("AAA");
adapter.FillSchema(dataset, "aaa"); // Fills the schema of "aaa", which already exists in the DataSet.
adapter.FillSchema(dataset, "Aaa"); // Adds a new table called "Aaa".

Se FillSchema for chamado e o DataSet contiver apenas um DataTable cujo nome difere apenas por caso, esse DataTable é atualizado. Neste cenário, a comparação não distingue minúsculas e maiúsculas. O seguinte código C# ilustra este comportamento.

DataSet dataset = new DataSet();
dataset.Tables.Add("aaa");
adapter.FillSchema(dataset, "AAA"); // Fills the schema of table "aaa" because only one similarly named table is in the DataSet.

FillSchema não devolve nenhuma linha. Use o Fill método para adicionar linhas a um DataTable.

Ao usar FillSchema, o .NET Framework Data Provider for SQL Server acrescenta uma cláusula FOR BROWSE à instrução que está a ser executada. O utilizador deve estar atento a potenciais efeitos secundários, como interferência com o uso das instruções SET FMTONLY ON. Para obter mais informações, consulte SET FMTONLY (Transact-SQL).

Notas para Herdeiros

Esta implementação do método FillSchema(DataSet, SchemaType) está protegida e foi concebida para utilização por um fornecedor de dados .NET Framework.

Ver também

• DbProviderFactories (ADO.NET)
• Visão geral ADO.NET

protected:
 virtual System::Data::DataTable ^ FillSchema(System::Data::DataTable ^ dataTable, System::Data::SchemaType schemaType, System::Data::IDbCommand ^ command, System::Data::CommandBehavior behavior);

protected virtual System.Data.DataTable FillSchema(System.Data.DataTable dataTable, System.Data.SchemaType schemaType, System.Data.IDbCommand command, System.Data.CommandBehavior behavior);

override this.FillSchema : System.Data.DataTable * System.Data.SchemaType * System.Data.IDbCommand * System.Data.CommandBehavior -> System.Data.DataTable

Protected Overridable Function FillSchema (dataTable As DataTable, schemaType As SchemaType, command As IDbCommand, behavior As CommandBehavior) As DataTable

Parâmetros

Devoluções

Um objeto de DataTable que contém informação do esquema devolvida da fonte de dados.

Observações

O FillSchema método recupera o esquema da fonte de dados usando o SelectCommand. O objeto de ligação associado ao SelectCommand deve ser válido, mas não precisa de ser aberto. Se a ligação for fechada antes FillSchema de ser chamada, é aberta para recuperar dados e depois fechada. Se a ligação estiver aberta antes FillSchema de ser chamada, permanece aberta.

Uma FillSchema operação adiciona a DataTable ao destino DataSet. Depois, adiciona colunas ao DataColumnCollection de DataTable, e configura as seguintes DataColumn propriedades se existirem na fonte de dados:

• AllowDBNull

• AutoIncrement. Deves definir AutoIncrementStep e AutoIncrementSeed separadamente.

• MaxLength

• ReadOnly

• Unique

FillSchema também configura as PrimaryKey propriedades e Constraints de acordo com as seguintes regras:

• Se uma ou mais colunas de chave primárias forem devolvidas pelo SelectCommand, elas são usadas como colunas de chave primárias para o DataTable.

• Se não forem devolvidas colunas de chave primárias mas colunas únicas forem, as colunas únicas são usadas como chave primária se, e só se, todas as colunas únicas forem não anuláveis. Se alguma das colunas for anulável, a UniqueConstraint é adicionado ao ConstraintCollection, mas a PrimaryKey propriedade não é definida.

• Se forem retornadas tanto as colunas chave primárias como as colunas únicas, as colunas principais primárias são usadas como as colunas principais primárias para o DataTable.

Note-se que as chaves primárias e as restrições únicas são adicionadas ao ConstraintCollection de acordo com as regras anteriores, mas outros tipos de restrições não são adicionados.

Se um único índice clusterizado for definido numa coluna ou colunas numa tabela SQL Server e a restrição principal da chave for definida num conjunto separado de colunas, então os nomes das colunas no índice clusterizado serão devolvidos. Para devolver o nome ou nomes das colunas de chave primária, use uma dica de consulta com a instrução SELECT que especifica o nome do índice de chave primária. Para mais informações sobre especificação de dicas de consulta, veja Dicas (Transact-SQL) - Consulta.

Se encontrar IDataAdapter colunas duplicadas ao preencher um DataTable, gera nomes para as colunas seguintes, usando o padrão "nome da coluna1", "nome da coluna2", "nome da coluna3", e assim sucessivamente. Se os dados recebidos contêm colunas sem nome, são colocadas segundo DataSet o padrão "Coluna 1", "Coluna 2", e assim sucessivamente. Quando vários conjuntos de resultados são adicionados, DataSet cada conjunto de resultados é colocado numa tabela separada. Conjuntos de resultados adicionais são nomeados adicionando valores integrais ao nome da tabela especificado (por exemplo, "Table", "Table1", "Table2", entre outros). Se a sua aplicação usar nomes de colunas e tabelas, certifique-se de que não há conflitos com esses padrões de nomenclatura.

FillSchema não devolve nenhuma linha. Use o Fill método para adicionar linhas a um DataTable.

Ao usar FillSchema, o .NET Framework Data Provider for SQL Server acrescenta uma cláusula FOR BROWSE à instrução que está a ser executada. O utilizador deve estar atento a potenciais efeitos secundários, como interferência com o uso das instruções SET FMTONLY ON. Para obter mais informações, consulte SET FMTONLY (Transact-SQL).

Notas para Herdeiros

Esta implementação do método FillSchema(DataSet, SchemaType) está protegida e foi concebida para utilização por um fornecedor de dados .NET Framework.

Ver também

• DbProviderFactories (ADO.NET)
• Visão geral ADO.NET

public:
 cli::array <System::Data::DataTable ^> ^ FillSchema(System::Data::DataSet ^ dataSet, System::Data::SchemaType schemaType, System::String ^ srcTable);

public System.Data.DataTable[] FillSchema(System.Data.DataSet dataSet, System.Data.SchemaType schemaType, string srcTable);

override this.FillSchema : System.Data.DataSet * System.Data.SchemaType * string -> System.Data.DataTable[]

Public Function FillSchema (dataSet As DataSet, schemaType As SchemaType, srcTable As String) As DataTable()

Parâmetros

Devoluções

Uma referência a uma coleção de DataTable objetos que foram adicionados ao DataSet.

Exceções

Exemplos

O exemplo seguinte usa a classe derivada, SqlDataAdapter, para preencher a DataSet com o esquema, e devolve um DataSet.

public static DataSet GetCustomerData(string dataSetName,
    string connectionString)
{
    DataSet dataSet = new DataSet(dataSetName);

    using (SqlConnection connection = new SqlConnection(connectionString))
    {
        SqlDataAdapter adapter = new SqlDataAdapter(
            "SELECT CustomerID, CompanyName, ContactName FROM dbo.Customers", connection);

        DataTableMapping mapping = adapter.TableMappings.Add("Table", "Customers");
        mapping.ColumnMappings.Add("CompanyName", "Name");
        mapping.ColumnMappings.Add("ContactName", "Contact");

        connection.Open();

        adapter.FillSchema(dataSet, SchemaType.Source, "Customers");
        adapter.Fill(dataSet);

        return dataSet;
    }
}

Private Function GetCustomerData(ByVal dataSetName As String, _
    ByVal connectionString As String) As DataSet

    Dim dataSet As New DataSet(dataSetName)

    Using connection As SqlConnection = New SqlConnection(connectionString)

        Dim adapter As New SqlDataAdapter( _
           "SELECT CustomerID, CompanyName, ContactName FROM dbo.Customers", _
           connection)

        Dim mapping As DataTableMapping = adapter.TableMappings.Add( _
           "Table", "Customers")
        mapping.ColumnMappings.Add("CompanyName", "Name")
        mapping.ColumnMappings.Add("ContactName", "Contact")

        connection.Open()

        adapter.FillSchema(dataSet, SchemaType.Source, "Customers")
        adapter.Fill(dataSet)
        Return dataSet
    End Using
End Function

Observações

Este método recupera a informação do esquema da fonte de dados usando o SelectCommand.

Uma FillSchema operação adiciona a DataTable ao destino DataSet. Depois, adiciona colunas ao DataColumnCollection de DataTable, e configura as seguintes DataColumn propriedades se existirem na fonte de dados:

• AllowDBNull

• AutoIncrement. Deves definir AutoIncrementStep e AutoIncrementSeed separadamente.

• MaxLength

• ReadOnly

• Unique

FillSchema também configura as PrimaryKey propriedades e Constraints de acordo com as seguintes regras:

• Se uma ou mais colunas de chave primárias forem devolvidas pelo SelectCommand, elas são usadas como colunas de chave primárias para o DataTable.

• Se não forem devolvidas colunas de chave primárias mas colunas únicas forem, as colunas únicas são usadas como chave primária se, e só se, todas as colunas únicas forem não anuláveis. Se alguma das colunas for anulável, a UniqueConstraint é adicionado ao ConstraintCollection, mas a PrimaryKey propriedade não é definida.

• Se forem retornadas tanto as colunas chave primárias como as colunas únicas, as colunas principais primárias são usadas como as colunas principais primárias para o DataTable.

Note-se que as chaves primárias e as restrições únicas são adicionadas ao ConstraintCollection de acordo com as regras anteriores, mas outros tipos de restrições não são adicionados.

Se um único índice clusterizado for definido numa coluna ou colunas numa tabela SQL Server e a restrição principal da chave for definida num conjunto separado de colunas, então os nomes das colunas no índice clusterizado serão devolvidos. Para devolver o nome ou nomes das colunas de chave primária, use uma dica de consulta com a instrução SELECT que especifica o nome do índice de chave primária. Para mais informações sobre especificação de dicas de consulta, veja Dicas (Transact-SQL) - Consulta.

A informação da chave primária é usada durante Fill o processo para encontrar e substituir quaisquer linhas cujas colunas chave coincidam. Se este não for o comportamento desejado, use Fill sem pedir informação do esquema.

Se encontrar DbDataAdapter colunas duplicadas ao preencher um DataTable, gera nomes para as colunas seguintes, usando o padrão "nome da coluna1", "nome da coluna2", "nome da coluna3", e assim sucessivamente. Se os dados recebidos contêm colunas sem nome, são colocadas segundo DataSet o padrão "Coluna 1", "Coluna 2", e assim sucessivamente. Quando vários conjuntos de resultados são adicionados, DataSet cada conjunto de resultados é colocado numa tabela separada. Conjuntos de resultados adicionais são nomeados adicionando valores integrais ao nome da tabela especificado (por exemplo, "Table", "Table1", "Table2", entre outros). Se a sua aplicação usar nomes de colunas e tabelas, certifique-se de que não há conflitos com esses padrões de nomenclatura.

O FillSchema método suporta cenários em que contém DataSet múltiplos DataTable objetos cujos nomes diferem apenas consoante o caso. Nessas situações, FillSchema realiza uma comparação sensível a maiúsculos e minúsculos para encontrar a tabela correspondente, criando uma nova tabela se não existir correspondência exata. O seguinte código C# ilustra este comportamento.

DataSet dataset = new DataSet();
dataset.Tables.Add("aaa");
dataset.Tables.Add("AAA");
adapter.FillSchema(dataset, "aaa"); // Fills the schema of "aaa", which already exists in the DataSet.
adapter.FillSchema(dataset, "Aaa"); // Adds a new table called "Aaa".

Se FillSchema for chamado e o DataSet contiver apenas um DataTable cujo nome difere apenas por caso, esse DataTable é atualizado. Neste cenário, a comparação não distingue minúsculas e maiúsculas. O seguinte código C# ilustra este comportamento.

DataSet dataset = new DataSet();
dataset.Tables.Add("aaa");
adapter.FillSchema(dataset, "AAA"); // Fills the schema of table "aaa" because only one similarly named table is in the DataSet.

O IDbConnection objeto associado ao comando select deve ser válido, mas não precisa de ser aberto. Se o IDbConnection for fechado antes FillSchema de ser chamado, é aberto para recuperar os dados, e depois fechado. Se a ligação estiver aberta antes FillSchema de ser chamada, fica aberta.

Ao usar FillSchema, o .NET Framework Data Provider for SQL Server acrescenta uma cláusula FOR BROWSE à instrução que está a ser executada. O utilizador deve estar atento a potenciais efeitos secundários, como interferência com o uso das instruções SET FMTONLY ON. Para obter mais informações, consulte SET FMTONLY (Transact-SQL).

Ver também

• DbProviderFactories
• Visão geral ADO.NET

public:
 System::Data::DataTable ^ FillSchema(System::Data::DataTable ^ dataTable, System::Data::SchemaType schemaType);

public System.Data.DataTable FillSchema(System.Data.DataTable dataTable, System.Data.SchemaType schemaType);

override this.FillSchema : System.Data.DataTable * System.Data.SchemaType -> System.Data.DataTable

Public Function FillSchema (dataTable As DataTable, schemaType As SchemaType) As DataTable

Parâmetros

Devoluções

A DataTable que contém informação do esquema devolvida da fonte de dados.

Exemplos

O exemplo seguinte usa a classe derivada, SqlDataAdapter, para preencher a DataSet com o esquema, e devolve um DataTable.

public static DataTable GetCustomerData(string dataSetName,
    string connectionString)
{
    DataTable table = new DataTable(dataSetName);

    using (SqlConnection connection = new SqlConnection(connectionString))
    {
        SqlDataAdapter adapter = new SqlDataAdapter(
            "SELECT CustomerID, CompanyName, ContactName FROM dbo.Customers", connection);

        DataTableMapping mapping = adapter.TableMappings.Add("Table", "Customers");
        mapping.ColumnMappings.Add("CompanyName", "Name");
        mapping.ColumnMappings.Add("ContactName", "Contact");

        connection.Open();

        adapter.FillSchema(table, SchemaType.Mapped);
        adapter.Fill(table);
        return table;
    }
}

Private Function GetCustomerData(ByVal dataTableName As String, _
    ByVal connectionString As String) As DataTable

    Dim table As New DataTable(dataTableName)

    Using connection As SqlConnection = New SqlConnection(connectionString)

        Dim adapter New SqlDataAdapter( _
           "SELECT CustomerID, CompanyName, ContactName FROM dbo.Customers", _
           connection)

        Dim mapping As DataTableMapping = adapter.TableMappings.Add( _
           "Table", "Customers")
        mapping.ColumnMappings.Add("CompanyName", "Name")
        mapping.ColumnMappings.Add("ContactName", "Contact")

        connection.Open()

        adapter.FillSchema(table, SchemaType.Mapped)
        adapter.Fill(table)
        Return table
    End Using
End Function

Observações

O FillSchema método recupera o esquema da fonte de dados usando o SelectCommand. O objeto de ligação associado ao SelectCommand deve ser válido, mas não precisa de ser aberto. Se a ligação for fechada antes FillSchema de ser chamada, é aberta para recuperar dados e depois fechada. Se a ligação estiver aberta antes FillSchema de ser chamada, permanece aberta.

Uma FillSchema operação devolve um DataTable. Depois, adiciona colunas ao DataColumnCollection de DataTable, e configura as seguintes DataColumn propriedades se existirem na fonte de dados:

• AllowDBNull

• AutoIncrement. Deves definir AutoIncrementStep e AutoIncrementSeed separadamente.

• MaxLength

• ReadOnly

• Unique

FillSchema também configura as PrimaryKey propriedades e Constraints de acordo com as seguintes regras:

• Se a PrimaryKey já foi definido para o DataTable, ou o DataTable contém dados, a PrimaryKey propriedade não será definida.

• Se uma ou mais colunas de chave primárias forem devolvidas pelo SelectCommand, elas são usadas como colunas de chave primárias para o DataTable.

• Se não forem devolvidas colunas de chave primárias mas colunas únicas forem, as colunas únicas são usadas como chave primária se, e só se, todas as colunas únicas forem não anuláveis. Se alguma das colunas for anulável, a UniqueConstraint é adicionado ao ConstraintCollection, mas a PrimaryKey propriedade não é definida.

• Se forem retornadas tanto as colunas chave primárias como as colunas únicas, as colunas principais primárias são usadas como as colunas principais primárias para o DataTable.

Note-se que as chaves primárias e as restrições únicas são adicionadas ao ConstraintCollection de acordo com as regras anteriores, mas outros tipos de restrições não são adicionados. Este processo pode exigir várias idas e voltas ao servidor.

Se um único índice clusterizado for definido numa coluna ou colunas numa tabela SQL Server e a restrição principal da chave for definida num conjunto separado de colunas, então os nomes das colunas no índice clusterizado serão devolvidos. Para devolver o nome ou nomes das colunas de chave primária, use uma dica de consulta com a instrução SELECT que especifica o nome do índice de chave primária. Para mais informações sobre especificação de dicas de consulta, veja Dicas (Transact-SQL) - Consulta.

Se encontrar DbDataAdapter colunas duplicadas ao preencher um DataTable, gera nomes para as colunas seguintes, usando o padrão "nome da coluna1", "nome da coluna2", "nome da coluna3", e assim sucessivamente. Se os dados recebidos contêm colunas sem nome, são colocadas segundo DataSet o padrão "Coluna 1", "Coluna 2", e assim sucessivamente. Quando vários conjuntos de resultados são adicionados, DataSet cada conjunto de resultados é colocado numa tabela separada. Conjuntos de resultados adicionais são nomeados adicionando valores integrais ao nome da tabela especificado (por exemplo, "Table", "Table1", "Table2", entre outros). Se a sua aplicação usar nomes de colunas e tabelas, certifique-se de que não há conflitos com esses padrões de nomenclatura.

FillSchema não devolve nenhuma linha. Use o Fill método para adicionar linhas a um DataTable.

Ao usar FillSchema, o .NET Framework Data Provider for SQL Server acrescenta uma cláusula FOR BROWSE à instrução que está a ser executada. O utilizador deve estar atento a potenciais efeitos secundários, como interferência com o uso das instruções SET FMTONLY ON. Para obter mais informações, consulte SET FMTONLY (Transact-SQL).

Ver também

• DbProviderFactories
• Visão geral ADO.NET

public:
 override cli::array <System::Data::DataTable ^> ^ FillSchema(System::Data::DataSet ^ dataSet, System::Data::SchemaType schemaType);

public override System.Data.DataTable[] FillSchema(System.Data.DataSet dataSet, System.Data.SchemaType schemaType);

override this.FillSchema : System.Data.DataSet * System.Data.SchemaType -> System.Data.DataTable[]

Public Overrides Function FillSchema (dataSet As DataSet, schemaType As SchemaType) As DataTable()

Parâmetros

Devoluções

Uma referência a uma coleção de DataTable objetos que foram adicionados ao DataSet.

Implementações

Exemplos

O exemplo seguinte usa a classe derivada, SqlDataAdapter, para preencher a DataSet com o esquema, e devolve um DataSet.

public static DataSet GetCustomerData(string dataSetName,
    string connectionString)
{
    DataSet dataSet = new DataSet(dataSetName);

    using (SqlConnection connection = new SqlConnection(connectionString))
    {
        SqlDataAdapter adapter = new SqlDataAdapter(
            "SELECT CustomerID, CompanyName, ContactName FROM dbo.Customers", connection);

        DataTableMapping mapping = adapter.TableMappings.Add("Table", "Customers");
        mapping.ColumnMappings.Add("CompanyName", "Name");
        mapping.ColumnMappings.Add("ContactName", "Contact");

        connection.Open();

        adapter.FillSchema(dataSet, SchemaType.Mapped);
        adapter.Fill(dataSet);

        return dataSet;
    }
}

Private Function GetCustomerData(ByVal dataSetName As String, _
    ByVal connectionString As String) As DataSet

    Dim dataSet As New DataSet(dataSetName)

    Using connection As SqlConnection = New SqlConnection(connectionString)
        Dim adapter As New SqlDataAdapter( _
           "SELECT CustomerID, CompanyName, ContactName FROM dbo.Customers", _
           connection)

        Dim mapping As DataTableMapping = adapter.TableMappings.Add( _
           "Table", "Customers")
        mapping.ColumnMappings.Add("CompanyName", "Name")
        mapping.ColumnMappings.Add("ContactName", "Contact")

        connection.Open()

        adapter.FillSchema(dataSet, SchemaType.Mapped)
        adapter.Fill(dataSet)
        Return dataSet
    End Using
End Function

Observações

Este método recupera a informação do esquema da fonte de dados usando o SelectCommand.

Uma FillSchema operação adiciona a DataTable ao destino DataSet. Depois, adiciona colunas ao DataColumnCollection de DataTable, e configura as seguintes DataColumn propriedades se existirem na fonte de dados:

• AllowDBNull

• AutoIncrement. Deves definir AutoIncrementStep e AutoIncrementSeed separadamente.

• MaxLength

• ReadOnly

• Unique

FillSchema também configura as PrimaryKey propriedades e Constraints de acordo com as seguintes regras:

• Se uma ou mais colunas de chave primárias forem devolvidas pelo SelectCommand, elas são usadas como colunas de chave primárias para o DataTable.

• Se não forem devolvidas colunas de chave primárias mas colunas únicas forem, as colunas únicas são usadas como chave primária se, e só se, todas as colunas únicas forem não anuláveis. Se alguma das colunas for anulável, a UniqueConstraint é adicionado ao ConstraintCollection, mas a PrimaryKey propriedade não é definida.

• Se forem retornadas tanto as colunas chave primárias como as colunas únicas, as colunas principais primárias são usadas como as colunas principais primárias para o DataTable.

Note-se que as chaves primárias e as restrições únicas são adicionadas ao ConstraintCollection de acordo com as regras anteriores, mas outros tipos de restrições não são adicionados.

Se um único índice clusterizado for definido numa coluna ou colunas numa tabela SQL Server e a restrição principal da chave for definida num conjunto separado de colunas, então os nomes das colunas no índice clusterizado serão devolvidos. Para devolver o nome ou nomes das colunas de chave primária, use uma dica de consulta com a instrução SELECT que especifica o nome do índice de chave primária. Para mais informações sobre especificação de dicas de consulta, veja Dicas (Transact-SQL) - Consulta.

A informação da chave primária é usada durante Fill o processo para encontrar e substituir quaisquer linhas cujas colunas chave coincidam. Se este não for o comportamento desejado, use Fill sem pedir informação do esquema.

Se encontrar IDataAdapter colunas duplicadas ao preencher um DataTable, gera nomes para as colunas seguintes, usando o padrão "nome da coluna1", "nome da coluna2", "nome da coluna3", e assim sucessivamente. Se os dados recebidos contêm colunas sem nome, são colocadas segundo DataSet o padrão "Coluna 1", "Coluna 2", e assim sucessivamente. Quando vários conjuntos de resultados são adicionados, DataSet cada conjunto de resultados é colocado numa tabela separada. Conjuntos de resultados adicionais são nomeados adicionando valores integrais ao nome da tabela especificado (por exemplo, "Table", "Table1", "Table2", entre outros). Se a sua aplicação usar nomes de colunas e tabelas, certifique-se de que não há conflitos com esses padrões de nomenclatura.

O IDbConnection objeto associado ao comando select deve ser válido, mas não precisa de ser aberto. Se o IDbConnection for fechado antes FillSchema de ser chamado, é aberto para recuperar os dados, e depois fechado. Se a ligação estiver aberta antes FillSchema de ser chamada, fica aberta.

Ao usar FillSchema, o .NET Framework Data Provider for SQL Server acrescenta uma cláusula FOR BROWSE à instrução que está a ser executada. O utilizador deve estar atento a potenciais efeitos secundários, como interferência com o uso das instruções SET FMTONLY ON. Para obter mais informações, consulte SET FMTONLY (Transact-SQL).

Ver também

• DbProviderFactories
• Visão geral ADO.NET