DataColumn.DataType, propriété (System.Data)

Bibliothèque de classes .NET Framework 
DataColumn.DataType, propriété 

Obtient ou définit le type des données stockées dans la colonne.

Espace de noms : System.Data
Assembly : System.Data (dans system.data.dll)

SyntaxeSyntaxe


Visual Basic (Déclaration)
Public Property DataType As Type


Visual Basic (Utilisation)
Dim instance As DataColumn
Dim value As Type

value = instance.DataType

instance.DataType = value


C#
public Type DataType { get; set; }


C++
public:
property Type^ DataType {
    Type^ get ();
    void set (Type^ value);
}


J#
/** @property */
public Type get_DataType ()

/** @property */
public void set_DataType (Type value)


JScript
public function get DataType () : Type

public function set DataType (value : Type)

Valeur de la propriété

Objet Type qui représente le type de données de la colonne.
ExceptionsExceptions
Type d'exceptionCondition

ArgumentException

La colonne contient déjà des données stockées.

? ou ?

AutoIncrement est true, mais sa valeur est un type non pris en charge par AutoIncrement.

NotesNotes

La définition de la valeur DataType est très importante pour garantir la création et la mise à jour correctes des données dans une source de données.

La propriété DataType prend en charge les types de données .NET Framework de base suivants :

ainsi que le type de tableau suivant :

  • Byte[]

Une exception est générée si vous modifiez cette propriété alors que la colonne a commencé à stocker des données.

Si vous affectez à AutoIncrement la valeur true avant de définir la propriété DataType et si vous essayez d'affecter au type une valeur autre qu'un type integer, une exception est générée.

RemarqueRemarque

Dans certains cas, une colonne de type de données Byte[] nécessite un traitement spécial puisque, contrairement aux types de données .NET Framework de base, il s'agit d'un type de données référence. Si une colonne de type de données Byte[] est utilisée en tant que PrimaryKey ou en tant que clé Sort ou RowFilter pour un DataView, toute modification à la valeur de colonne doit impliquer l'assignation de la valeur de colonne Byte[] à un objet Byte[] instancié séparément. Cette assignation est requise pour déclencher la mise à jour des index internes utilisés par les opérations de tri, de filtrage et de clé primaire. L'exemple suivant illustre ces propos :



byte[] columnValue = (byte[])myDataTable.Rows[0][0];
byte[] newValue = (byte[])columnValue.Clone();
newValue[1] = 2;
myDataTable.Rows[0][0] = newValue;
RemarqueRemarque

Bien qu'il soit possible de définir une colonne comme un type de données autre que les types de données .NET Framework de base et Byte[], une telle colonne sera traitée comme un type défini par l'utilisateur et sera sujette aux restrictions d'utilisation suivantes. (Pour plus d'informations sur les types définis par l'utilisateur, consultez Création et utilisation de types définis par l'utilisateur.)

ExempleExemple

L'exemple suivant ajoute des colonnes de différents types de données à DataTable, puis ajoute une ligne à la table.



Visual Basic
Public Function MakeDataTable() As DataTable
    
    Dim myTable As DataTable 
    Dim myNewRow As DataRow 
    ' Create a new DataTable.
    myTable = New DataTable("My Table")
 
    ' Create DataColumn objects of data types.
    Dim colString As DataColumn = New DataColumn("StringCol")
    colString.DataType = System.Type.GetType("System.String")
    myTable.Columns.Add(colString) 
 
    Dim colInt32 As DataColumn = New DataColumn("Int32Col")
    colInt32.DataType = System.Type.GetType("System.Int32")
    myTable.Columns.Add(colInt32)
 
    Dim colBoolean As DataColumn = New DataColumn("BooleanCol")
    colBoolean.DataType = System.Type.GetType("System.Boolean")
    myTable.Columns.Add(colBoolean)
 
    Dim colTimeSpan As DataColumn = New DataColumn("TimeSpanCol")
    colTimeSpan.DataType = System.Type.GetType("System.TimeSpan")
    myTable.Columns.Add(colTimeSpan)
 
    Dim colDateTime As DataColumn = New DataColumn("DateTimeCol")
    colDateTime.DataType = System.Type.GetType("System.DateTime")
    myTable.Columns.Add(colDateTime)
 
    Dim colDecimal As DataColumn = New DataColumn("DecimalCol")
    colDecimal.DataType = System.Type.GetType("System.Decimal")
    myTable.Columns.Add(colDecimal)
 
    ' Populate one row with values.
    myNewRow = myTable.NewRow()
 
    myNewRow("StringCol") = "Item Name"
    myNewRow("Int32Col") = 2147483647
    myNewRow("BooleanCol") = True
    myNewRow("TimeSpanCol") = New TimeSpan(10,22,10,15,100)
    myNewRow("DateTimeCol") = System.DateTime.Today
    myNewRow("DecimalCol") = 64.0021
    myTable.Rows.Add(myNewRow)
    MakeDataTable = myTable  
 End Function


C#
public DataTable MakeDataTable(){
    
    DataTable myTable;
    DataRow myNewRow; 
    // Create a new DataTable.
    myTable = new DataTable("My Table");
 
    // Create DataColumn objects of data types.
    DataColumn colString = new DataColumn("StringCol");
    colString.DataType = System.Type.GetType("System.String");
    myTable.Columns.Add(colString); 
 
    DataColumn colInt32 = new DataColumn("Int32Col");
    colInt32.DataType = System.Type.GetType("System.Int32");
    myTable.Columns.Add(colInt32);
 
    DataColumn colBoolean = new DataColumn("BooleanCol");
    colBoolean.DataType = System.Type.GetType("System.Boolean");
    myTable.Columns.Add(colBoolean);
 
    DataColumn colTimeSpan = new DataColumn("TimeSpanCol");
    colTimeSpan.DataType = System.Type.GetType("System.TimeSpan");
    myTable.Columns.Add(colTimeSpan);
 
    DataColumn colDateTime = new DataColumn("DateTimeCol");
    colDateTime.DataType = System.Type.GetType("System.DateTime");
    myTable.Columns.Add(colDateTime);
 
    DataColumn colDecimal = new DataColumn("DecimalCol");
    colDecimal.DataType = System.Type.GetType("System.Decimal");
    myTable.Columns.Add(colDecimal);
 
    // Populate one row with values.
    myNewRow = myTable.NewRow();
 
    myNewRow["StringCol"] = "Item Name";
    myNewRow["Int32Col"] = 2147483647;
    myNewRow["BooleanCol"] = true;
    myNewRow["TimeSpanCol"] = new TimeSpan(10,22,10,15,100);
    myNewRow["DateTimeCol"] = System.DateTime.Today;
    myNewRow["DecimalCol"] = 64.0021;
    myTable.Rows.Add(myNewRow);
    return myTable;  
 }
Plates-formesPlates-formes

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile pour Pocket PC, Windows Mobile pour Smartphone, Windows Server 2003, Windows XP Édition Media Center, Windows XP Professionnel Édition x64, Windows XP SP2, Windows XP Starter Edition

Le .NET Framework ne prend pas en charge toutes les versions de chaque plate-forme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise.

Informations de versionInformations de version

.NET Framework

Prise en charge dans : 2.0, 1.1, 1.0

.NET Compact Framework

Prise en charge dans : 2.0, 1.0
Voir aussiVoir aussi

Ces informations proviennent du site de http://msdn2.microsoft.com
Source de cette page : http://msdn2.microsoft.com/fr-fr/library/system.data.datacolumn.datatype.aspx

Réseaux sociaux

Vous pouvez modifier vos préférences dans votre profil pour ne plus afficher les interactions avec les réseaux sociaux sur ces pages.

 

Nuage de mots clés

9 mots clés dont 0 définis manuellement (plus d'information...).

Avertissement

Cette page ne possède pas encore de mots clés manuels, ceci est donc un exemple automatique (les niveaux de pertinence sont fictifs, mais les liens sont valables). Pour tester le nuage avec une page qui contient des mots définis manuellement, vous pouvez cliquer ici.

Vous pouvez modifier vos préférences dans votre profil pour ne plus afficher le nuage de mots clés.

 

Astuce pour imprimer les couleurs des cellules de tableaux : http://www.gaudry.be/ast-rf-450.html
Aucun commentaire pour cette page

© Ce document issu de l′infobrol est enregistré sous le certificat Cyber PrInterDeposit Digital Numbertection. Enregistrement IDDN n° 5329-4367
Document créé le 18/10/06 03:53, dernière modification le Vendredi 17 Juin 2011, 12:11
Source du document imprimé : http://www.gaudry.be/dotnet-rf-system.data.datacolumn.datatype.html Document affiché 4 fois ce mois de Mai.
St.Gaudry©07.01.02
Outils (masquer)
||
Recherche (afficher)
Recherche :

Utilisateur (masquer)
Apparence (afficher)
Stats (afficher)
15832 documents
452 astuces.
549 niouzes.
3099 definitions.
447 membres.
8115 messages.

Document genere en :
0,56 seconde

Mises à jour :
Mises à jour du site
Citation (masquer)
Aimer, c'est trouver, grâce à un autre, sa vérité et aider cet autre à trouver la sienne. C'est créer une complicité passionnée.

Jacques de Bourbon Busset
 
l'infobrol
Nous sommes le Jeudi 31 Mai 2012, 18:59, toutes les heures sont au format GMT+1.00 Heure, heure d'été (+1)