Compartilhar via


Coleções de esquema comuns

As coleções de esquemas comuns são as coleções de esquemas implementadas por todos os provedores gerenciados do .NET Framework. Consulte um provedor gerenciado do .NET Framework 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". Isso 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 mais colunas se desejado. Por exemplo, SqlClient e OracleClient adicionam 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 de esquema expõe informações sobre todas as coleções de esquemas com suporte do provedor gerenciado pelo .NET Framework 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, em SQL Server, isso seria três para tabelas e quatro para colunas. No Oracle, seria 2 para tabelas e 3 para colunas.

DataSourceInformation

Essa coleção de esquemas expõe informações sobre a fonte de dados à qual o provedor gerenciado pelo .NET Framework 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 SQL Server) ou "@|\.". (para Oracle).

Um identificador composto é o que normalmente se usa 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 "\.". Para OracleClient, use "@|\.".

Para o ODBC, use o Catalog_name_separator.

Para OLE DB, use DBLITERAL_CATALOG_SEPARATOR ou DBLITERAL_SCHEMA_SEPARATOR.
DataSourceProductName string O nome do produto acessado pelo provedor, como “Oracle” ou "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. No caso do OLE DB e do ODBC, eles sempre serão os mesmos que são mapeados para a mesma chamada de função na API nativa subjacente.
DataSourceProductVersionNormalized string Uma versão normalizada para a fonte de dados, de modo que ela possa ser comparada com String.Compare(). O formato disso é 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 provedor Oracle usa um formato "nn.nn.nn.nn.nn" para sua versão normalizada, o que faz com que uma fonte de dados Oracle 8i retorne "08.01.07.04.01". O SQL Server usa o formato típico da Microsoft "nn.nn.nnnn".

Em alguns casos, DataSourceProductVersion e DataSourceProductVersionNormalized terão o mesmo valor. No caso do OLE DB e do ODBC, eles sempre serão os mesmos que são mapeados para a mesma chamada de função na API nativa subjacente.
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 igual a true indica que elas devem estar na lista de seleção, e um valor igual a false indica que elas não devem estar 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 ':', isso será ":{0}". Ao formatar isso com um nome de parâmetro "P1", a cadeia de caracteres resultante será ":p1".

Se a fonte de dados esperar que os parâmetros sejam prefixados com a '@', mas os nomes já os incluírem, isso será '{0}', e o resultado da formatação de um parâmetro chamado "@p1" será simplesmente "@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 simplesmente como '?', o que ignora o nome do parâmetro. Para o OLE DB, retornamos '?'.
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 a ser incluído no nome do parâmetro, isso seria: "(@[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, isso seria: ":([A-Za-z0-9_$#]*)".

Obviamente, se a fonte de dados não der suporte a parâmetros nomeados, isso simplesmente 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 sobre os 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 tiver usado 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 gerenciado pelo .NET Framework 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 ou OracleType.Blob.
ColumnSize long O tamanho de uma coluna não numérica ou um parâmetro se refere ao máximo ou ao tamanho definido para esse tipo pelo provedor.

Para dados de caractere, esse é o máximo ou o tamanho definido em unidades, definido pela fonte de dados. A Oracle tem o conceito de especificar o comprimento e então especificar o tamanho real do armazenamento para alguns tipos de dados de caracteres. Isso define apenas o comprimento em unidades para Oracle.

Para tipos de dados de data/hora, esse é 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 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 Framework 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.

Observe que isso 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 Framework indicado pelo valor da 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 é idêntico, a coluna IsBestMatch é 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: é desconhecido 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 valor nulo.

false: o tipo de dados não permite valor nulo.

DBNull.Value: é desconhecido se o 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 aplicável ao tipo de dados.
MaximumScale short Se o indicador de tipo for um tipo numérico, esse será o número máximo de dígitos permitidos à direita do ponto decimal. Caso contrário, é DBNull.Value.
MinimumScale short Se o indicador de tipo for um tipo numérico, esse será o número mínimo de dígitos permitidos à direita do ponto decimal. Caso contrário, é 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 dados
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.
NativeDataType String NativeDataType é uma coluna específica do OLE DB para expor o tipo OLE DB do tipo de dados.

Restrições

Essa coleção de esquemas expôs informações sobre as restrições compatíveis com o provedor gerenciado pelo .NET Framework 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 gerenciado pelo .NET Framework está atualmente conectado.

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

Confira também