SqlConnection.GetSchema Method (String, String[])

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

Namespace: System.Data.SqlClient
Assembly: System.Data (in system.data.dll)

public override DataTable GetSchema (
	string collectionName,
	string[] restrictionValues
public DataTable GetSchema (
	String collectionName, 
	String[] restrictionValues
public override function GetSchema (
	collectionName : String, 
	restrictionValues : String[]
) : DataTable
Not applicable.



Specifies the name of the schema to return.


A set of restriction values for the requested schema.

Return Value

A DataTable that contains schema information.

When collectionName is specified as null, the DataTable contains information about all the metadata that is available, and its restrictions.

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 a null reference (Nothing in Visual Basic) 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 need to pass in the following values: 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 a null reference (Nothing in Visual Basic), 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.

Windows 98, Windows Server 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0