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. |