OleDbConnection.GetOleDbSchemaTable(Guid, Object[]) Méthode

public:
 System::Data::DataTable ^ GetOleDbSchemaTable(Guid schema, cli::array <System::Object ^> ^ restrictions);

public System.Data.DataTable GetOleDbSchemaTable (Guid schema, object[] restrictions);

public System.Data.DataTable? GetOleDbSchemaTable (Guid schema, object?[]? restrictions);

member this.GetOleDbSchemaTable : Guid * obj[] -> System.Data.DataTable

Public Function GetOleDbSchemaTable (schema As Guid, restrictions As Object()) As DataTable

Paramètres

Retours

DataTable qui contient les informations de schéma demandées.

Exceptions

Exemples

L’exemple suivant retourne une liste de tables dans une base de données.

static DataTable GetSchemaTable(string connectionString)
{
    using (OleDbConnection connection = new
               OleDbConnection(connectionString))
    {
        connection.Open();
        DataTable schemaTable = connection.GetOleDbSchemaTable(
            OleDbSchemaGuid.Tables,
            new object[] { null, null, null, "TABLE" });
        return schemaTable;
    }
}

Public Function GetSchemaTable(ByVal connectionString As String) _
    As DataTable

    Using connection As New OleDbConnection(connectionString)
        connection.Open()

        Dim schemaTable As DataTable = _
            connection.GetOleDbSchemaTable(OleDbSchemaGuid.Tables, _
            New Object() {Nothing, Nothing, Nothing, "TABLE"})
        Return schemaTable
    End Using
End Function

Remarques

La table de schéma est retournée sous la forme d’un DataTable qui a le même format que l’ensemble de lignes de schéma OLE DB spécifié par le schema paramètre . Utilisez le restrictions paramètre pour filtrer les lignes à retourner dans (par exemple, en spécifiant des restrictions pour le DataTable nom de la table, le type, le propriétaire ou le schéma). Lorsque vous transmettez des valeurs dans le tableau, incluez des chaînes vides ou des valeurs null pour les éléments du tableau qui ne contiennent pas de valeurs. Si vous passez un tableau vide à restrictions, toutes les lignes (une pour chaque table) sont retournées dans l’ordre par défaut. Les valeurs du tableau correspondent à l’ordre des colonnes dans la table source et DataTable. Chaque élément du tableau de restrictions est comparé au contenu de la colonne correspondante dans l’ensemble de lignes de schéma. Par exemple, le premier élément du tableau de restrictions est comparé à la première colonne de l’ensemble de lignes. Si un élément de restriction n’est pas null, seules les lignes de l’ensemble de lignes de schéma qui correspondent exactement à la valeur de la restriction sont ajoutées au résultat DataTable.

La OleDbConnection méthode appelle la méthode OLE DB IDBSchemaRowset::GetRowset sous-jacente à l’aide des règles de conversion du Common Language Runtime standard. Pour plus d’informations, consultez Types de données COM.

Vous pouvez récupérer des informations sur les littéraux à l’aide de DbInfoLiterals. Cela fournit des informations équivalentes à l’appel de l’interface OLE DB IDBInfo::GetLiteralInfo ou de la méthode ADO Connection.OpenSchema avec la adSchemaDBInfoLiterals constante .

S’applique à

Voir aussi

• Connexion à des sources de données