Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
Export (0) Print
Expand All

DbConnection.GetSchema Method (String, String[])

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

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

public virtual DataTable GetSchema(
	string collectionName,
	string[] restrictionValues
)

Parameters

collectionName
Type: System.String

Specifies the name of the schema to return.

restrictionValues
Type: System.String[]

Specifies 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 three restrictions (database, owner, and table name) and you want to get back only the tables associated with the owner "Carl", you must pass in the following values at least: 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 from 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.

If the connection is associated with a transaction, executing GetSchema calls may cause some providers to throw an exception.

.NET Framework

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

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

XNA Framework

Supported in: 3.0, 2.0, 1.0
Show:
© 2015 Microsoft