This documentation is archived and is not being maintained.

OleDbConnection.GetOleDbSchemaTable Method

Returns schema information from a data source as indicated by a GUID, and after it applies the specified restrictions.

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

member GetOleDbSchemaTable : 
        schema:Guid * 
        restrictions:Object[] -> DataTable 


Type: System.Guid
One of the OleDbSchemaGuid values that specifies the schema table to return.
Type: System.Object[]
An Object array of restriction values. These are applied in the order of the restriction columns. That is, the first restriction value applies to the first restriction column, the second restriction value applies to the second restriction column, and so on.

Return Value

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


The specified set of restrictions is invalid.


The OleDbConnection is closed.


The specified schema rowset is not supported by the OLE DB provider.


The schema parameter contains a value of DbInfoLiterals and the restrictions parameter contains one or more restrictions.

The schema table is returned as a DataTable that has the same format as the OLE DB schema rowset specified by the schema parameter. Use the restrictions parameter to filter the rows to be returned in the DataTable (for example, by specifying restrictions for table name, type, owner, or schema). When you pass values in the array, include empty strings or nulls for array elements that do not contain values. If you pass an empty array to restrictions, all rows (one for each table) are returned in default order. Values in the array correspond to the order of the columns in the source table and DataTable. Each element in the restrictions array is compared with the content of the corresponding column in the schema rowset. For example, the first element in the restrictions array is compared to first column in the rowset. If a restriction element is not null, only rows from the schema rowset that exactly match the value of the restriction are added to the resulting DataTable.

The OleDbConnection method calls the underlying OLE DB IDBSchemaRowset::GetRowset method using standard common language runtime conversion rules. For more information, see COM Data Types.

You can retrieve information about literals by using DbInfoLiterals. This provides information equivalent to calling the OLE DB IDBInfo::GetLiteralInfo interface, or the ADO Connection.OpenSchema method with the adSchemaDBInfoLiterals constant.

The following sample returns a list of tables in a database.

No code example is currently available or this language may not be supported.

.NET Framework

Supported in: 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

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