OracleConnection.GetSchema Método

  • Referência

Definição

Namespace:
System.Data.OracleClient
Assembly:
System.Data.OracleClient.dll

Retorna informações de esquema para a fonte de dados deste OracleConnection.

Sobrecargas

GetSchema()

Retorna informações de esquema para a fonte de dados deste OracleConnection.
GetSchema(String)

Retorna informações de esquema para a fonte de dados deste OracleConnection usando a cadeia de caracteres especificada para o nome do esquema.
GetSchema(String, String[])

Retorna informações de esquema para a fonte de dados desse OracleConnection usando a cadeia de caracteres especificada para o nome do esquema e a matriz de cadeia de caracteres especificada para os valores de restrição.

GetSchema()

Retorna informações de esquema para a fonte de dados deste OracleConnection.

public:
 override System::Data::DataTable ^ GetSchema();
public override System.Data.DataTable GetSchema ();
override this.GetSchema : unit -> System.Data.DataTable
Public Overrides Function GetSchema () As DataTable

Retornos

DataTable

Um DataTable que contém informações de esquema.

Confira também

Aplica-se a

GetSchema(String)

Retorna informações de esquema para a fonte de dados deste OracleConnection usando a cadeia de caracteres especificada para o nome do esquema.

public:
 override System::Data::DataTable ^ GetSchema(System::String ^ collectionName);
public override System.Data.DataTable GetSchema (string collectionName);
override this.GetSchema : string -> System.Data.DataTable
Public Overrides Function GetSchema (collectionName As String) As DataTable

Parâmetros

collectionName
String

Especifica o nome do esquema a retornar.

Retornos

DataTable

Um DataTable que contém informações de esquema.

Exceções

ArgumentException

collectionName é especificado como nulo.

Comentários

As consultas que usam GetSchema diferenciam maiúsculas de minúsculas. Devido ao tratamento da Oracle de casos em que um esquema é criado pela primeira vez, isso pode levar a resultados inesperados.

Se o esquema tiver sido criado sem aspas, a Oracle armazenará o nome do objeto em maiúsculas, . Se o esquema tiver sido criado com aspas, a Oracle armazenará o nome do objeto no uso de maiúsculas e minúsculas fornecido.

Por exemplo, suponha que você crie uma tabela chamada MyTable, usando uma das duas instruções a seguir:

CREATE TABLE MyTable ...

CREATE TABLE "MyTable" ...

Para recuperar informações sobre essa tabela por meio do método GetSchema no primeiro caso, você teria que passar "MYTABLE" como um argumento. No segundo caso, você teria que passar "MyTable" como um argumento.

Confira também

Aplica-se a

GetSchema(String, String[])

Retorna informações de esquema para a fonte de dados desse OracleConnection usando a cadeia de caracteres especificada para o nome do esquema e a matriz de cadeia de caracteres especificada para os valores de restrição.

public:
 override System::Data::DataTable ^ GetSchema(System::String ^ collectionName, cli::array <System::String ^> ^ restrictionValues);
public override System.Data.DataTable GetSchema (string collectionName, string[] restrictionValues);
override this.GetSchema : string * string[] -> System.Data.DataTable
Public Overrides Function GetSchema (collectionName As String, restrictionValues As String()) As DataTable

Parâmetros

collectionName
String

Especifica o nome do esquema a retornar.

restrictionValues
String[]

Um conjunto de valores de restrição para o esquema solicitado.

Retornos

DataTable

Um DataTable que contém informações de esquema.

Exceções

ArgumentException

collectionName é especificado como nulo.

Comentários

O restrictionValues parâmetro pode fornecer n profundidade de valores especificados pela coleção de restrições para uma coleção específica. Para definir valores em uma determinada restrição e não definir os valores de outras restrições, você precisa definir as restrições anteriores como nulas e, em seguida, colocar o valor apropriado para a restrição para a qual você gostaria de especificar um valor.

Um exemplo disso é a coleção "Tables". Se a coleção "Tables" tiver três restrições: banco de dados, proprietário e nome da tabela; e você deseja recuperar apenas as tabelas associadas ao proprietário "Carl", então você precisaria passar os seguintes valores (no mínimo): nulo, "Carl". Se um valor de restrição não for passado, os valores padrão serão usados para essa restrição. Esse é o mesmo mapeamento que passar nulo, que é diferente de passar uma cadeia de caracteres vazia para o valor do parâmetro. Nesse caso, a cadeia de caracteres vazia ("") é considerada o valor do parâmetro especificado.

As consultas que usam GetSchema diferenciam maiúsculas de minúsculas. Devido ao tratamento da Oracle de casos em que um esquema é criado pela primeira vez, isso pode levar a resultados inesperados.

Se o esquema tiver sido criado sem aspas, a Oracle armazenará o nome do objeto em maiúsculas, . Se o esquema tiver sido criado com aspas, a Oracle armazenará o nome do objeto no uso de maiúsculas e minúsculas fornecido.

Por exemplo, suponha que você crie uma tabela chamada MyTable, usando uma das duas instruções a seguir:

CREATE TABLE MyTable ...

CREATE TABLE "MyTable" ...

Para recuperar informações sobre essa tabela por meio do método GetSchema no primeiro caso, você teria que passar "MYTABLE" como um argumento. No segundo caso, você teria que passar "MyTable" como um argumento.

Confira também

Aplica-se a