SqlDataReader.GetSchemaTable Método

Definição

Namespace:

System.Data.SqlClient

Assembly:

System.Data.dll

Retorna um DataTable que descreve os metadados da coluna do SqlDataReader.

public:
 override System::Data::DataTable ^ GetSchemaTable();

public override System.Data.DataTable GetSchemaTable ();

override this.GetSchemaTable : unit -> System.Data.DataTable

Public Overrides Function GetSchemaTable () As DataTable

Retornos

DataTable

Um DataTable que descreve os metadados de coluna.

Implementações

GetSchemaTable()

Exceções

InvalidOperationException

O SqlDataReader está fechado.

Comentários

O GetSchemaTable método retorna os seguintes metadados sobre cada coluna:

Coluna DataReader	Descrição
AllowDBNull	Defina se o consumidor pode definir a coluna como um valor nulo ou se o provedor não pode determinar se o consumidor pode definir a coluna como um valor nulo. Caso contrário, não definido. Uma coluna pode conter valores nulos mesmo se não puder ser ajustada para um valor nulo.
BaseCatalogName	O nome do catálogo no repositório de dados que contém a coluna. NULL se o nome do catálogo base não puder ser determinado. O padrão dessa coluna é um valor nulo.
BaseColumnName	O nome da coluna no armazenamento de dados. Isso poderá ser diferente do nome da coluna retornado na coluna ColumnName se um alias tiver sido usado. Um valor nulo se o nome da coluna base não puder ser determinado ou se a coluna do conjunto de linhas for derivada, mas não idêntica a, uma coluna no armazenamento de dados. O padrão dessa coluna é um valor nulo.
BaseSchemaName	O nome do esquema no repositório de dados que contém a coluna. Um valor nulo se o nome do esquema de base não pode ser determinado. O padrão dessa coluna é um valor nulo.
BaseServerName	O nome da instância do Microsoft SQL Server usado pelo SqlDataReader.
BaseTableName	O nome da tabela ou exibição no repositório de dados que contém a coluna. Um valor nulo se o nome da tabela de base não pode ser determinado. O padrão dessa coluna é um valor nulo.
ColumnName	O nome da coluna; isso pode não ser exclusivo. Se isso não puder ser determinado, um valor nulo será retornado. Este nome sempre reflete a renomeação mais recente da coluna na exibição atual ou no texto do comando.
ColumnOrdinal	O ordinal com base em zero da coluna. Esta coluna não pode ter um valor nulo.
ColumnSize	O comprimento máximo possível de um valor na coluna. Para colunas que usam um tipo de dados de comprimento fixo, esse é o tamanho do tipo de dados. Para nvarchar(MAX)as colunas , varchar(MAX)e varbinary(MAX) armazenadas em um banco de dados SQL Server, o tamanho máximo é de 2 GB. Se essas colunas forem armazenadas e acessadas como arquivos, o limite de tamanho máximo será imposto pelo sistema de arquivos. Esse valor é alterado ao usar o Type System Version palavra-chave no cadeia de conexão. Para novos tipos, eles são representados como tipos de nível inferior. Os tipos de dados MAX retornam os 4k normais para nvarchar e 8000 para varchar. Para obter mais informações, consulte a referência do Transact-SQL.
DataTypeName	Retorna uma cadeia de caracteres que representa o tipo de dados da coluna especificada.
IsAliased	true: o nome da coluna é um alias. false: o nome da coluna não é um alias.
IsAutoIncrement	true: a coluna atribui valores a novas linhas em incrementos fixos. false: a coluna não atribui valores a novas linhas em incrementos fixos. O padrão desta coluna é false.
IsColumnSet	true: a coluna é uma coluna esparsa que é um membro de um conjunto de colunas.
Isexpression	true: a coluna é uma expressão. false: a coluna não é uma expressão.
IsHidden	true: a coluna está oculta. false: a coluna não está oculta.
IsIdentity	true: a coluna é uma coluna de identidade. false: a coluna não é uma coluna de identidade.
IsKey	true: a coluna é um de um conjunto de colunas no conjunto de linhas que, juntos, identificam exclusivamente a linha. O conjunto de colunas com IsKey definido como true deve identificar exclusivamente uma linha no conjunto de linhas. Não há nenhum requisito de que esse conjunto de colunas seja um conjunto mínimo de colunas. Esse conjunto de colunas pode ser gerado por meio de uma chave primária da tabela de base, uma restrição exclusiva ou um índice exclusivo. false: a coluna não é necessária para identificar exclusivamente a linha.
IsLong	true: a coluna contém um BLOB (Objeto Binário Longo) que contém dados muito longos. A definição de dados muito grandes é específica do provedor. false: a coluna não contém um BLOB (Objeto Binário Longo) que contém dados muito longos.
IsReadOnly	true: a coluna não pode ser modificada. false: a coluna pode ser modificada.
IsRowVersion	true: a coluna contém um identificador de linha persistente que não pode ser gravado e não tem nenhum valor significativo, exceto para identificar a linha. false: a coluna não contém um identificador de linha persistente que não pode ser gravado e não tem nenhum valor significativo, exceto para identificar a linha.
IsUnique	true: a coluna é do tipo timestamp. false: a coluna não é do tipo timestamp.
NonVersionedProviderType	O tipo da coluna, independentemente do atual Type System Version especificado no cadeia de conexão. O valor retornado é da SqlDbType enumeração .
NumericPrecision	Se ProviderType for um tipo de dados numérico, essa será a precisão máxima da coluna. A precisão depende da definição da coluna. Se ProviderType não for um tipo de dados numérico, será 255.
NumericScale	Se ProviderType for DBTYPE_DECIMAL ou DBTYPE_NUMERIC, o número de dígitos à direita do ponto decimal. Caso contrário, isso é 255.
ProviderSpecificDataType	Retorna o tipo de dados específico do provedor da coluna com base no Type System Version palavra-chave no cadeia de conexão.
ProviderType	O indicador do tipo de dados da coluna. Se o tipo de dados da coluna variar de linha para linha, ele deverá ser Object. Esta coluna não pode ter um valor nulo.
UdtAssemblyQualifiedName	Se a coluna for um UDT (tipo definido pelo usuário), esse será o nome qualificado do assembly do UDT de acordo AssemblyQualifiedNamecom . Se a coluna não for um UDT, isso será nulo.
Xmlschemacollectiondatabase	O nome do banco de dados em que a coleção de esquemas para essa instância XML está localizada, se a linha contiver informações sobre uma coluna XML. Esse valor será null (Nothing no Visual Basic) se a coleção for definida no banco de dados atual. Ele também será nulo se não houver nenhuma coleção de esquema, nesse caso, as XmlSchemaCollectionName colunas e XmlSchemaCollectionOwningSchema também serão nulas.
Xmlschemacollectionname	O nome da coleção de esquemas para essa instância XML, se a linha contiver informações sobre uma coluna XML. Esse valor será null (Nothing no Visual Basic) se não houver nenhuma coleção de esquemas associada. Se o valor for nulo, as XmlSchemaCollectionDatabase colunas e XmlSchemaCollectionOwningSchema também serão nulas.
Xmlschemacollectionowningschema	O esquema relacional proprietário em que a coleção de esquemas para essa instância XML está localizada, se a linha contiver informações sobre uma coluna XML. Esse valor será null (Nothing no Visual Basic) se a coleção for definida no banco de dados atual. Ele também será nulo se não houver nenhuma coleção de esquema, nesse caso, as XmlSchemaCollectionDatabase colunas e XmlSchemaCollectionName também serão nulas.

Observação

Para garantir que as colunas de metadados retornem as informações corretas, você deve chamar ExecuteReader com o behavior parâmetro definido KeyInfocomo . Caso contrário, algumas das colunas na tabela de esquema podem retornar dados padrão, nulos ou incorretos.

Confira também

• Visão geral do ADO.NET