Export (0) Print
Expand All

OracleConnection.GetSchema Method (String, String())

Returns schema information for the data source of this OracleConnection using the specified string for the schema name and the specified string array for the restriction values.

Namespace:  System.Data.OracleClient
Assembly:  System.Data.OracleClient (in System.Data.OracleClient.dll)

'Declaration
Public Overrides Function GetSchema ( _
	collectionName As String, _
	restrictionValues As String() _
) As DataTable

Parameters

collectionName
Type: System.String

Specifies the name of the schema to return.

restrictionValues
Type: System.String()

A set of restriction values for the requested schema.

Return Value

Type: System.Data.DataTable
A DataTable that contains schema information.

ExceptionCondition
ArgumentException

collectionName is specified as null.

The restrictionValues parameter can supply n depth of values which are specified by the restrictions collection for a specific collection. In order to set values on a given restriction, and not set the values of other restrictions, you need to set the preceding restrictions to null and then put the appropriate value in for the restriction that you would like to specify a value for.

An example of this is the "Tables" collection. If the "Tables" collection has 3 restrictions: database, owner, and table name; and you want to get back only the tables associated with the owner "Carl", then you would need to pass in the following values (at a minimum): null, "Carl". If a restriction value is not passed in, the default values are used for that restriction. This is the same mapping as passing in null, which is different than passing in an empty string for the parameter value. In that case, the empty string ("") is considered to be the value for the specified parameter.

Queries using GetSchema are case sensitive. Because of Oracle's treatment of cases when a schema is first created, this can lead to unexpected results.

If the schema was created without quotes, Oracle stores the object name in upper case. If the schema was created with quotes, Oracle stores the object name in the casing provided.

For example, suppose that you create a table called MyTable, using one of the following two statements:

CREATE TABLE MyTable ...

CREATE TABLE "MyTable" ...

To retrieve information about this table via the GetSchema method in the first case, you would have to pass "MYTABLE" in as an argument. In the second case, you would have to pass "MyTable" in as an argument.

.NET Framework

Supported in: 4.5, 4, 3.5, 3.0, 2.0

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Show:
© 2014 Microsoft