Comment faire pour récupérer un schéma de colonne à l'aide de la méthode GetSchemaTable de DataReader et Visual c#.NET

Traductions disponibles Traductions disponibles
Numéro d'article: 310107 - Voir les produits auxquels s'applique cet article
Agrandir tout | Réduire tout

Sommaire

Résumé

Cet article montre comment utiliser la méthode GetSchemaTable de l'objet DataReader dans ADO.NET pour récupérer des informations de schéma de colonne. Un autre nom de schéma d'une colonne est ses propriétés de champ. Informations de schéma de colonne inclut les informations suivantes sur la colonne :
  • Nom
  • Type de données
  • Taille
  • Indique si la colonne est un champ clé primaire
  • Indique si la colonne est un NuméroAuto (AutoIncrement) champ
La méthode GetSchemaTable retourne une propriété DataTable qui contient le schéma de colonne pour un objet DataReader. Le DataTable contient une ligne pour chaque champ dans le jeu de résultats. Chaque colonne correspond à une propriété du champ dans le jeu de résultats. La propriété ColumnName de la colonne du DataTable est le nom de la propriété du champ, telles que la propriété ColumnName, DataType, ColumnSize, IsKeyColumnou IsAutoIncrement . La valeur de la colonne du DataTable est la valeur de la propriété du champ, telles que la valeur de prénom pour la propriété ColumnName .
Remarque : Pour obtenir des informations de clé primaire, y compris si un champ est partie d'une clé primaire et si elle est un champ d'auto-incrémentation , vous devez définir la valeur CommandBehavior du DataReader à CommandBehavior.KeyInfo.

Vous pouvez utiliser la méthode GetSchemaTable avec soit le OLE DB.NET OLE DB ou le SQL.NET Fournisseur. La méthode OleDbDataReader.GetSchemaTable correspond à la méthode OLE DB IColumnsRowset::GetColumnsRowset . La méthode SqlDataReader.GetSchemaTable n'utilise pas une couche de fournisseur OLE DB.

De la note, sauf si vous utilisez explicitement la méthode GetSchemaTable , DataReader ne retourne pas de schéma de colonne. En outre, si vous utilisez GetSchemaTable pour extraire le schéma de colonne, vous ne peut pas mettre à jour le DataReader. Le DataReader récupère toujours un flux en lecture seule et avant uniquement des données à partir d'un base de données.

Quand utiliser la méthode GetSchemaTable

  • L'objet SqlConnection ne gère pas la récupération des informations de schéma SQL Server dans une méthode analogue à la méthode GetOleDbSchemaTable de l'objet OleDbConnection . La méthode GetSchemaTable de la classe SqlDataReader offre un moyen simple pour obtenir le schéma de colonne informations de SQL Server.
  • Bien que la méthode GetOleDbSchemaTable de l'objet OleDbConnection peut renvoyer de base de données et informations de schéma de colonne, table Vous constaterez peut-être que la méthode GetSchemaTable de l'objet DataReader est plus facile à utiliser si vous souhaitez récupérer uniquement les colonnes informations de schéma.
  • Vous pouvez utiliser la méthode GetSchemaTable pour créer un nouveau DataTable basé sur le schéma d'une propriété DataTable existante lorsque vous personnalisez les noms de colonnes et d'autres attributs de colonne. Pour exemple de code qui montre comment utiliser GetSchemaTable pour définir une nouvelle table, reportez-vous à la « Visual Studio exemples : Fitch et Mather 7.0 exécuter la requête SQL » rubrique dans la Visual Studio de Microsoft.NET en ligne Documentation d'aide.

Récupérer un schéma de colonne avec le fournisseur OLE DB.NET pour ODBC

Cet exemple répertorie les informations de schéma pour les colonnes (champs Propriétés) de la table Employees de Northwind SQL Server base de données.

Notez que lorsque vous utilisez le fournisseur de données OLE DB.NET pour ODBC, vous utilisez la méthode GetSchemaTable de l'objet OleDbDataReader .
  1. Démarrez Visual Studio.NET et créez ensuite un nouveau projet Visual c# Projet d'Application console. Class1.cs est créé par défaut.
  2. Ouvrez la fenêtre de Code de Class1. Collez le code suivant en haut de la fenêtre de Code au-dessus de la déclaration d'espace de noms :
    using System.Data;
    using System.Data.OleDb;
    					
  3. Dans la fenêtre Code, collez le code suivant dans la fonction Main :
    OleDbConnection cn = new OleDbConnection();
    OleDbCommand cmd = new OleDbCommand();
    DataTable schemaTable; 
    OleDbDataReader myReader; 
    			 
    //Open a connection to the SQL Server Northwind database.
    cn.ConnectionString = "Provider=SQLOLEDB;Data Source=server;User ID=login;
                           Password=password;Initial Catalog=Northwind";
    cn.Open();
    
    //Retrieve records from the Employees table into a DataReader.
    cmd.Connection = cn;
    cmd.CommandText = "SELECT * FROM Employees";
    myReader = cmd.ExecuteReader(CommandBehavior.KeyInfo); 
    
    //Retrieve column schema into a DataTable.
    schemaTable = myReader.GetSchemaTable();
    
    //For each field in the table...
    foreach (DataRow myField in schemaTable.Rows){
        //For each property of the field...
        foreach (DataColumn myProperty in schemaTable.Columns) {
    	//Display the field name and value.
    	Console.WriteLine(myProperty.ColumnName + " = " + myField[myProperty].ToString());
        }
        Console.WriteLine();
    
        //Pause.
        Console.ReadLine();
    }
    
    //Always close the DataReader and connection.
    myReader.Close();
    cn.Close();
    					
  4. Modifier les paramètres de la propriété ConnectionString pour se connecter correctement à votre SQL Server ordinateur.
  5. Appuyez sur la touche F5 pour compiler et exécuter le projet. Avis que les propriétés de chaque champ sont répertoriées dans la fenêtre de Console.
  6. Appuyez sur ENTRÉE pour faire défiler la liste, fin de la console application et revenir à l'environnement de développement intégré (IDE).

Récupérer un schéma de colonne avec le SQL.NET pour ODBC

Cet exemple répertorie les informations de schéma pour les colonnes (champs Propriétés) de la table Employees de Northwind SQL Server base de données.

Notez que lorsque vous utilisez le SQL.NET pour ODBC, vous utilisez la méthode GetSchemaTable de l'objet SqlDataReader .
  1. Démarrez Visual Studio.NET, puis créez un nouveau projet Visual c# Projet d'Application console. Class1.cs est créé par défaut.
  2. Ouvrez la fenêtre de Code de Class1. Collez le code suivant en haut de la fenêtre de Code au-dessus de la déclaration d'espace de noms :
    using System.Data;
    using System.Data.SqlClient;
    					
  3. Dans la fenêtre Code, collez le code suivant dans la fonction Main :
    SqlConnection cn = new SqlConnection();
    SqlCommand cmd = new SqlCommand();
    DataTable schemaTable; 
    SqlDataReader myReader; 
    			 
    //Open a connection to the SQL Server Northwind database.
    cn.ConnectionString = "Data Source=server;User ID=login;
                           Password=password;Initial Catalog=Northwind";
    cn.Open();
    
    //Retrieve records from the Employees table into a DataReader.
    cmd.Connection = cn;
    cmd.CommandText = "SELECT * FROM Employees";
    myReader = cmd.ExecuteReader(CommandBehavior.KeyInfo);
    
    //Retrieve column schema into a DataTable.
    schemaTable = myReader.GetSchemaTable();
    
    //For each field in the table...
    foreach (DataRow myField in schemaTable.Rows){
        //For each property of the field...
        foreach (DataColumn myProperty in schemaTable.Columns) {
    	//Display the field name and value.
    	Console.WriteLine(myProperty.ColumnName + " = " + myField[myProperty].ToString());
        }
        Console.WriteLine();
    
        //Pause.
        Console.ReadLine();
    }
    
    //Always close the DataReader and connection.
    myReader.Close();
    cn.Close();
    					
  4. Modifier les paramètres de la propriété ConnectionString pour se connecter correctement à votre SQL Server ordinateur.
  5. Appuyez sur F5 pour compiler et exécuter le projet. Notez que le Propriétés de chaque champ sont répertoriées dans la fenêtre de Console.
  6. Appuyez sur ENTRÉE pour faire défiler la liste, fin de la console application et retourner dans l'IDE.

Références

Pour plus d'informations sur le DataReader et la méthode GetSchemaTable , consultez les rubriques suivantes dans le Visual Studio.NET en ligne Documentation d'aide :
Récupération de données à l'aide de DataReader

Méthode IDataReader.GetSchemaTable

Remarque: cette rubrique contient une liste complète des colonnes dans le DataTableretourné.

Méthode OleDbDataReader.GetSchemaTable

Méthode SqlDataReader.GetSchemaTable
Pour plus d'informations sur l'utilisation de la méthode GetOleDbSchemaTable de l'objet OleDbConnection pour récupérer des informations de schéma, cliquez sur le numéro de l'article ci-dessous pour afficher l'article correspondant dans la Base de connaissances Microsoft :
309681 Comment faire pour récupérer des informations de schéma à l'aide de GetOleDbSchemaTable et Visual c#.NET

Propriétés

Numéro d'article: 310107 - Dernière mise à jour: mardi 12 juin 2012 - Version: 1.0
Les informations contenues dans cet article s'appliquent au(x) produit(s) suivant(s):
  • Microsoft ADO.NET 1.1
  • Microsoft Visual C# .NET 2003 Initiation
  • Microsoft Visual C# .NET 2002 Initiation
Mots-clés : 
kbdatabase kbhowtomaster kbsqlclient kbsystemdata kbmt KB310107 KbMtfr
Traduction automatique
IMPORTANT : Cet article est issu du système de traduction automatique mis au point par Microsoft (http://support.microsoft.com/gp/mtdetails). Un certain nombre d?articles obtenus par traduction automatique sont en effet mis à votre disposition en complément des articles traduits en langue française par des traducteurs professionnels. Cela vous permet d?avoir accès, dans votre propre langue, à l?ensemble des articles de la base de connaissances rédigés originellement en langue anglaise. Les articles traduits automatiquement ne sont pas toujours parfaits et peuvent comporter des erreurs de vocabulaire, de syntaxe ou de grammaire (probablement semblables aux erreurs que ferait une personne étrangère s?exprimant dans votre langue !). Néanmoins, mis à part ces imperfections, ces articles devraient suffire à vous orienter et à vous aider à résoudre votre problème. Microsoft s?efforce aussi continuellement de faire évoluer son système de traduction automatique.
La version anglaise de cet article est la suivante: 310107
L'INFORMATION CONTENUE DANS CE DOCUMENT EST FOURNIE PAR MICROSOFT SANS GARANTIE D'AUCUNE SORTE, EXPLICITE OU IMPLICITE. L'UTILISATEUR ASSUME LE RISQUE DE L'UTILISATION DU CONTENU DE CE DOCUMENT. CE DOCUMENT NE PEUT ETRE REVENDU OU CEDE EN ECHANGE D'UN QUELCONQUE PROFIT.

Envoyer des commentaires

 

Contact us for more help

Contact us for more help
Connect with Answer Desk for expert help.
Get more support from smallbusiness.support.microsoft.com