Assembly : System.Data (dans system.data.dll)
SyntaxePublic Property ColumnName As String
Dim instance As DataColumn Dim value As String value = instance.ColumnName instance.ColumnName = value
public string ColumnName { get; set; }
public: property String^ ColumnName { String^ get (); void set (String^ value); }
/** @property */ public String get_ColumnName () /** @property */ public void set_ColumnName (String value)
public function get ColumnName () : String public function set ColumnName (value : String)
Valeur de la propriété
Nom de la colonne.
Exceptions| Type d'exception | Condition |
|---|---|
| La valeur référence Null (Nothing en Visual Basic) ou une chaîne vide est affectée à la propriété et la colonne appartient à une collection. | |
| Une colonne portant le même nom existe déjà dans la collection. La comparaison des noms ne respecte pas la casse. |
NotesLorsque DataColumn est créé, il ne possède aucune valeur ColumnName. Toutefois, lorsque DataColumn est ajouté à un DataColumnCollection pour un objet DataTable, un nom par défaut ("Column1", "Column2", etc.) lui est attribué.
Par défaut, la valeur Caption est définie comme la valeur ColumnName.
ExempleLes exemples suivants obtiennent le ColumnName de chaque colonne de toutes les tables de DataSet. L'exemple suivant montre également comment créer un DataColumn avec un nouveau ColumnName.
Private Sub PrintColumnNames(dataSet As DataSet) Dim table As DataTable Dim column As DataColumn ' For each DataTable, print the ColumnName. For Each table in dataSet.Tables For Each column in table.Columns Console.WriteLine(column.ColumnName) Next Next End Sub Private Sub AddColumn(table As DataTable) Dim column As DataColumn column = New DataColumn() With column .ColumnName = "SupplierID" .DataType = System.Type.GetType("System.String") .Unique = True .AutoIncrement = False .Caption = "SupplierID" .ReadOnly = False End With ' Add the column to the table's columns collection. table.Columns.Add(column) End Sub
private void PrintColumnNames(DataSet dataSet) { // For each DataTable, print the ColumnName. foreach(DataTable table in dataSet.Tables) { foreach(DataColumn column in table.Columns) { Console.WriteLine(column.ColumnName); } } } private void AddColumn(DataTable table) { DataColumn column; column = new DataColumn(); column.ColumnName = "SupplierID"; column.DataType = System.Type.GetType("System.String"); column.Unique = true; column.AutoIncrement = false; column.Caption = "SupplierID"; column.ReadOnly = false; // Add the column to the table's columns collection. table.Columns.Add(column); }
Plates-formesWindows 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 version
Outils (masquer)
S'enregistrer
Liste des Membres
Qui est en ligne?
FAQ