Compartilhar via

Coleções de esquemas comuns

  • Artigo

Aplicável a: .NET Framework .NET .NET Standard

Baixar ADO.NET

As coleções de esquemas comuns são as coleções de esquemas que são implementadas por todos os provedores gerenciados do .NET. Consulte um provedor gerenciado do .NET para determinar a lista de coleções de esquemas compatíveis chamando o método GetSchema sem argumentos ou com o nome da coleção de esquemas "MetaDataCollections". Esse método retornará uma DataTable com uma lista de coleções de esquemas compatíveis, o número de restrições ao qual cada uma dá suporte e o número de partes de identificador usado por elas. Essas coleções descrevem todas as colunas necessárias. Os provedores são livres para adicionar colunas se desejado. Por exemplo, o Provedor de Dados Microsoft SqlClient para SQL Server adiciona ParameterName à coleção de restrições.

Se um provedor não puder determinar o valor de uma coluna necessária, ele retornará nulo.

Para obter mais informações sobre como usar os métodos GetSchema, confira GetSchema e coleções de esquemas.

MetaDataCollections

Essa coleção expõe informações sobre todas as coleções de esquemas com suporte do provedor que é usado atualmente para se conectar ao banco de dados.

ColumnName Tipo de dados Descrição
CollectionName string O nome da coleção a ser transmitida para o método GetSchema para retornar a coleção.
NumberOfRestrictions int O número de restrições que podem ser especificadas para a coleção.
NumberOfIdentifierParts int O número de partes no nome do objeto de banco de dados/identificador composto. Por exemplo, no SQL Server, o valor seria três para tabelas e quatro para colunas.

DataSourceInformation

Essa coleção de esquemas expõe informações sobre a fonte de dados à qual o Provedor de Dados Microsoft SqlClient para SQL Server está conectado no momento.

ColumnName Tipo de dados Descrição
CompositeIdentifierSeparatorPattern string A expressão regular usada para corresponder os separadores compostos em um identificador composto. Por exemplo, \. (para o SQL Server).

Um identificador composto normalmente é o que é usado para um nome de objeto de banco de dados, por exemplo: pubs.dbo.authors ou pubs@dbo.authors.

Para o SQL Server, use a expressão regular \..
DataSourceProductName string O nome do produto acessado pelo provedor, como "SQLServer".
DataSourceProductVersion string Indica a versão do produto acessada pelo provedor, no formato nativo de fontes de dados e não no formato da Microsoft.

Em alguns casos, DataSourceProductVersion e DataSourceProductVersionNormalized terão o mesmo valor.
DataSourceProductVersionNormalized string Uma versão normalizada para a fonte de dados, de modo que ela possa ser comparada com String.Compare(). Esse formato é consistente para todas as versões do provedor a fim de impedir que a versão 10 seja classificada entre a versão 1 e a versão 2.

Por exemplo, o SQL Server usa o formato nn.nn.nnnn típico da Microsoft.

Em alguns casos, DataSourceProductVersion e DataSourceProductVersionNormalized terão o mesmo valor.
GroupByBehavior GroupByBehavior Especifica a relação entre as colunas em uma cláusula GROUP BY e as colunas não agregadas na lista de seleção.
IdentifierPattern string Uma expressão regular que corresponde a um identificador e tem um valor de correspondência do identificador. Por exemplo, [A-Za-z0-9_#$].
IdentifierCase IdentifierCase Indica se identificadores que não estão entre aspas são tratados como diferenciando maiúsculas de minúsculas.
OrderByColumnsInSelect bool Especifica se as colunas em uma cláusula ORDER BY precisam estar na lista de seleção. Um valor true indica que é necessário que eles estejam na lista de seleção. Um valor false indica que não é necessário que eles estejam na lista de seleção.
ParameterMarkerFormat string Uma cadeia de caracteres de formato que representa como formatar um parâmetro.

Se os parâmetros nomeados forem compatíveis com a fonte de dados, o primeiro espaço reservado nessa cadeia de caracteres deverá ser o local em que o nome do parâmetro deve ser formatado.

Por exemplo, se a fonte de dados espera que os parâmetros sejam nomeados e prefixados com um :, essa cadeia de caracteres será :{0}. Ao formatar esse parâmetro com um nome de p1, a cadeia de caracteres resultante será :p1.

Se a fonte de dados esperar que os parâmetros sejam prefixados com o @, mas os nomes já os incluírem, essa cadeia de caracteres será "{0}", e o resultado da formatação de um parâmetro chamado @p1 será apenas @p1.

Para as fontes de dados que não esperam parâmetros nomeados e esperam o uso do caractere ?, a cadeia de caracteres de formato pode ser especificada como ?, o que ignora o nome do parâmetro.
ParameterMarkerPattern string Uma expressão regular que corresponde a um marcador de parâmetro. Ele terá um valor de correspondência do nome do parâmetro, se houver.

Por exemplo, se houver suporte para parâmetros nomeados com um caractere @ à esquerda que será incluído no nome do parâmetro, esse padrão será (\@[A-Za-z0-9_$#]*).

No entanto, se houver suporte para parâmetros nomeados com um : como o caractere à esquerda e ele não fizer parte do nome do parâmetro, esse padrão será :([A-Za-z0-9_$#]\*).

Se a fonte de dados não der suporte a parâmetros nomeados, esse padrão será ?.
ParameterNameMaxLength int O tamanho máximo de um nome de parâmetro em caracteres. O Visual Studio espera que, se houver suporte para nomes de parâmetro, o valor mínimo para o tamanho máximo será de 30 caracteres.

Se a fonte de dados não der suporte a parâmetros nomeados, essa propriedade retornará zero.
ParameterNamePattern string Uma expressão regular que corresponde aos nomes de parâmetros válidos. Fontes de dados diferentes têm regras diferentes em relação aos caracteres que podem ser usados como nomes de parâmetros.

O Visual Studio espera que, se houver suporte para nomes de parâmetros, os caracteres \p{Lu}\p{Ll}\p{Lt}\p{Lm}\p{Lo}\p{Nl}\p{Nd} sejam o conjunto mínimo de caracteres compatíveis válidos para nomes de parâmetros.
QuotedIdentifierPattern string Uma expressão regular que corresponde a um identificador entre aspas e tem um valor de correspondência do próprio identificador sem aspas. Por exemplo, se a fonte de dados tiver usado aspas duplas para identificar identificadores entre aspas, esse padrão será (([^\\"]\|\\"\\")*).
QuotedIdentifierCase IdentifierCase Indica se os identificadores entre aspas são tratados como diferenciando maiúsculas de minúsculas.
StatementSeparatorPattern string Uma expressão regular que corresponde ao separador de instrução.
StringLiteralPattern string Uma expressão regular que corresponde a um literal de cadeia de caracteres e tem um valor de correspondência do próprio literal. Por exemplo, se a fonte de dados usou aspas simples para identificar cadeias de caracteres, esse padrão será ('([^']\|'')*')'
SupportedJoinOperators SupportedJoinOperators Especifica quais tipos de instruções SQL de junção são compatíveis com a fonte de dados.

DataTypes

Essa coleção de esquemas expõe informações sobre os tipos de dados compatíveis com o banco de dados ao qual o provedor está atualmente conectado.

ColumnName Tipo de dados Descrição
TypeName string O nome de tipo de dados específico do provedor.
ProviderDbType int O valor do tipo específico do provedor que deve ser usado ao especificar o tipo de um parâmetro. Por exemplo, SqlDbType.Money.
ColumnSize long O comprimento de uma coluna ou parâmetro não numérico. Esse valor se refere ao máximo ou ao comprimento definido para esse tipo pelo provedor.

Para dados de caractere, esse valor é o máximo ou o tamanho definido em unidades, definido pela fonte de dados.

Para tipos de dados de data/hora, esse valor é o tamanho da representação de cadeia de caracteres (supondo que o máximo permitiu a precisão do componente em segundos fracionários).

Se o tipo de dados for numérico, esse valor será o limite superior na precisão máxima do tipo de dados.
CreateFormat string Cadeia de caracteres de formato que representa como adicionar essa coluna a uma instrução de definição de dados, como CREATE TABLE. Cada elemento da matriz CreateParameter deve ser representado por um "marcador de parâmetro" na cadeia de caracteres de formato.

Por exemplo, o tipo de dados SQL DECIMAL exige uma precisão e uma escala. Nesse caso, a cadeia de caracteres de formato será DECIMAL({0},{1}).
CreateParameters string Os parâmetros de criação que precisam ser especificados ao criar uma coluna desse tipo de dados. Cada parâmetro de criação é listado na cadeia de caracteres, separado por uma vírgula na ordem em que deve ser fornecido.

Por exemplo, o tipo de dados SQL DECIMAL exige uma precisão e uma escala. Nesse caso, os parâmetros de criação devem conter a cadeia de caracteres "precisão, escala".

Em um comando de texto, para criar uma coluna DECIMAL com uma precisão igual a 10 e uma escala igual a 2, o valor da coluna CreateFormat poderá ser DECIMAL({0},{1}) e a especificação de tipo completa será DECIMAL(10,2).
Tipo de dados string O nome do tipo .NET do tipo de dados.
IsAutoincrementable bool true – Os valores desse tipo de dados podem ser incrementados automaticamente.

false – Os valores desse tipo de dados podem não ser incrementados automaticamente.

Essa propriedade apenas indica se uma coluna desse tipo de dados pode ser incrementada automaticamente, não que todas as colunas desse tipo sejam incrementadas automaticamente.
IsBestMatch bool true – O tipo de dados é a melhor correspondência entre todos os tipos de dados do armazenamento de dados e o tipo de dados .NET indicado pelo valor na coluna DataType.

false – O tipo de dados não é a melhor correspondência.

Para cada conjunto de linhas no qual o valor da coluna DataType for idêntico, a coluna IsBestMatch será definida como true em apenas uma linha.
IsCaseSensitive bool true – O tipo de dados é um tipo de caractere e diferencia maiúsculas de minúsculas.

false – O tipo de dados não é um tipo de caractere ou não diferencia maiúsculas de minúsculas.
IsFixedLength bool true – Colunas desse tipo de dados criadas pela DDL (linguagem de definição de dados) terão um comprimento fixo.

false – Colunas desse tipo de dados criadas pela DDL terão um comprimento variável.

DBNull.Value – Não se sabe se o provedor mapeará esse campo com uma coluna de comprimento fixo ou variável.
IsFixedPrecisionScale bool true – O tipo de dados tem uma precisão e uma escala fixas.

false – O tipo de dados não tem uma precisão e uma escala fixas.
IsLong bool true – O tipo de dados contém dados muito longos; a definição de dados muito longos é específica do provedor.

false – O tipo de dados não contém dados muito longos.
IsNullable bool true – O tipo de dados permite valores nulos.

false – O tipo de dados não permite valores nulos.

DBNull.Value – Não se sabe se tipo de dados permite valores nulos.
IsSearchable bool true – O tipo de dados pode ser usado em uma cláusula WHERE com qualquer operador, exceto o predicado LIKE.

false – O tipo de dados não pode ser usado em uma cláusula WHERE com nenhum operador, exceto o predicado LIKE.
IsSearchableWithLike bool true – O tipo de dados pode ser usado com o predicado LIKE.

false – O tipo de dados não pode ser usado com o predicado LIKE.
IsUnsigned bool true – O tipo de dados é sem sinal.

false – O tipo de dados é com sinal.

DBNull.Value – Não se aplica ao tipo de dados.
MaximumScale short Se o indicador de tipo for um tipo numérico, esse valor será o número máximo de dígitos permitidos à direita do ponto decimal. Do contrário, esse valor será DBNull.Value.
MinimumScale short Se o indicador de tipo for um tipo numérico, esse valor será o número mínimo de dígitos permitidos à direita do ponto decimal. Do contrário, esse valor será DBNull.Value.
IsConcurrencyType bool true – O tipo de dados é atualizado pelo banco de dados sempre que a linha é alterada e o valor da coluna é diferente de todos os valores anteriores.

false – O tipo de dados não é atualizado pelo banco de dados sempre que a linha é alterada.

DBNull.Value – O banco de dados não dá suporte a esse tipo de dado.
IsLiteralSupported bool true – O tipo de dados pode ser expresso como um literal.

false – O tipo de dados não pode ser expresso como um literal.
LiteralPrefix string O prefixo aplicado a um literal específico.
LiteralSuffix string O sufixo aplicado a um literal específico.

Restrições

Essa coleção de esquemas expôs informações sobre as restrições compatíveis com o provedor que é atualmente usado para se conectar ao banco de dados.

ColumnName Tipo de dados Descrição
CollectionName string O nome da coleção à qual essas restrições se aplicam.
RestrictionName string O nome da restrição na coleção.
RestrictionDefault string Ignorado.
RestrictionNumber int A localização real nas restrições de coleções em que essa restrição específica se enquadra.

ReservedWords

Essa coleção de esquemas expõe informações sobre as palavras reservadas pelo banco de dados ao qual o provedor está atualmente conectado.

ColumnName Tipo de dados Descrição
ReservedWord string Palavra reservada específica do provedor.

Confira também