Partage via


DataColumn Constructeurs

Définition

Initialise une nouvelle instance de la classe DataColumn.

Surcharges

DataColumn()

Initialise une nouvelle instance de la DataColumn classe en tant que chaîne de type.

DataColumn(String)

Initialise une nouvelle instance de la classe DataColumn, comme chaîne de type, à l'aide du nom de colonne spécifié.

DataColumn(String, Type)

Initialise une nouvelle instance de la classe DataColumn à l'aide du nom de colonne et du type de données spécifiés.

DataColumn(String, Type, String)

Initialise une nouvelle instance de la classe DataColumn à l'aide du nom, du type de données et de l'expression spécifiés.

DataColumn(String, Type, String, MappingType)

Initialise une nouvelle instance de la classe DataColumn à l'aide du nom, du type de données et de l'expression spécifiés, ainsi que d'une valeur qui détermine si la colonne est un attribut.

DataColumn()

Source:
DataColumn.cs
Source:
DataColumn.cs
Source:
DataColumn.cs

Initialise une nouvelle instance de la DataColumn classe en tant que chaîne de type.

public:
 DataColumn();
public DataColumn ();
Public Sub New ()

Exemples

L’exemple suivant crée un , DataColumndéfinit différentes propriétés et l’ajoute à un DataColumnCollection pour l’objet DataTable .

private void AddDataColumn(DataTable table)
{
    DataColumn column = new DataColumn();

    // Set various properties.
    column.ColumnName = "id";
    column.DataType = System.Type.GetType("System.Int32");
    column.AutoIncrement = true;
    column.AutoIncrementSeed = 1;
    column.AutoIncrementStep = 1;
    column.ReadOnly = true;

    // Add to Columns collection.
    table.Columns.Add(column);
}
Private Sub AddDataColumn(ByVal table As DataTable)
    Dim column As New DataColumn()

    ' Set various properties.
    With column
       .ColumnName = "id"
       .DataType = System.Type.GetType("System.Int32")
       .AutoIncrement = True
       .AutoIncrementSeed = 1
       .AutoIncrementStep = 1
       .ReadOnly = True
     End With

    ' Add to Columns collection.
    table.Columns.Add(column)
End Sub

Remarques

Lorsqu’il est créé, un DataColumn objet n’a pas de valeur par défaut ColumnName ou Caption. Lorsque vous l’ajoutez à un DataColumnCollection, un nom par défaut (« Column1 », « Column2 », etc.) est généré si aucun nom n’a été attribué à .ColumnName

Voir aussi

S’applique à

DataColumn(String)

Source:
DataColumn.cs
Source:
DataColumn.cs
Source:
DataColumn.cs

Initialise une nouvelle instance de la classe DataColumn, comme chaîne de type, à l'aide du nom de colonne spécifié.

public:
 DataColumn(System::String ^ columnName);
public DataColumn (string? columnName);
public DataColumn (string columnName);
new System.Data.DataColumn : string -> System.Data.DataColumn
Public Sub New (columnName As String)

Paramètres

columnName
String

Chaîne qui représente le nom de la colonne à créer. Si sa valeur est null ou une chaîne vide (""), un nom par défaut est spécifié lors de son ajout à la collection de colonnes.

Exemples

L’exemple suivant crée un nouveau DataColumn avec un spécifié ColumnName.

private void AddDataColumn(DataTable table)
{
    DataColumn column = new DataColumn("id");

    // Set various properties.
    column.DataType = System.Type.GetType("System.Int32");
    column.AutoIncrement = true;
    column.AutoIncrementSeed = 1;
    column.AutoIncrementStep = 1;
    column.ReadOnly = true;

    // Add to Columns collection.
    table.Columns.Add(column);
}

Private Sub AddDataColumn(ByVal table As DataTable)
    Dim column As DataColumn 
    column = New DataColumn("id")

    ' Set various properties.
    With column
       .DataType = System.Type.GetType("System.Int32")
       .AutoIncrement = True
       .AutoIncrementSeed = 1
       .AutoIncrementStep = 1
       .ReadOnly = True
     End With

    ' Add to Columns collection.
    table.Columns.Add(column)
End Sub

Remarques

Par défaut, le nom spécifique à une colonne devient la valeur de la Caption propriété.

Voir aussi

S’applique à

DataColumn(String, Type)

Source:
DataColumn.cs
Source:
DataColumn.cs
Source:
DataColumn.cs

Initialise une nouvelle instance de la classe DataColumn à l'aide du nom de colonne et du type de données spécifiés.

public:
 DataColumn(System::String ^ columnName, Type ^ dataType);
public DataColumn (string? columnName, Type dataType);
public DataColumn (string columnName, Type dataType);
new System.Data.DataColumn : string * Type -> System.Data.DataColumn
Public Sub New (columnName As String, dataType As Type)

Paramètres

columnName
String

Chaîne qui représente le nom de la colonne à créer. Si sa valeur est null ou une chaîne vide (""), un nom par défaut est spécifié lors de son ajout à la collection de colonnes.

dataType
Type

DataType pris en charge.

Exceptions

Aucun dataType n'est spécifié.

Exemples

L’exemple suivant crée un nouveau DataColumn avec un spécifié ColumnName et DataType.

private void AddDataColumn(DataTable table)
{
    System.Type typeInt32 =
        System.Type.GetType("System.Int32");
    DataColumn column = new DataColumn("id", typeInt32);

    // Set various properties.
    column.AutoIncrement = true;
    column.AutoIncrementSeed = 1;
    column.AutoIncrementStep = 1;
    column.ReadOnly = true;

    // Add to Columns collection.
    table.Columns.Add(column);
}

Private Sub AddDataColumn(ByVal table As DataTable)
    
   Dim typeInt32 As System.Type = _
      System.Type.GetType("System.Int32")
   Dim column As DataColumn = _
       New DataColumn("id", typeInt32)

   ' Set various properties.
   With column
      .AutoIncrement = True
      .AutoIncrementSeed = 1
      .AutoIncrementStep = 1
      .ReadOnly = True
    End With

   ' Add to Columns collection.
   table.Columns.Add(column)
End Sub

Voir aussi

S’applique à

DataColumn(String, Type, String)

Source:
DataColumn.cs
Source:
DataColumn.cs
Source:
DataColumn.cs

Initialise une nouvelle instance de la classe DataColumn à l'aide du nom, du type de données et de l'expression spécifiés.

public:
 DataColumn(System::String ^ columnName, Type ^ dataType, System::String ^ expr);
public DataColumn (string? columnName, Type dataType, string? expr);
public DataColumn (string columnName, Type dataType, string expr);
new System.Data.DataColumn : string * Type * string -> System.Data.DataColumn
Public Sub New (columnName As String, dataType As Type, expr As String)

Paramètres

columnName
String

Chaîne qui représente le nom de la colonne à créer. Si sa valeur est null ou une chaîne vide (""), un nom par défaut est spécifié lors de son ajout à la collection de colonnes.

dataType
Type

DataType pris en charge.

expr
String

Expression utilisée pour créer cette colonne. Pour plus d'informations, consultez la propriété Expression.

Exceptions

Aucun dataType n'est spécifié.

Exemples

L’exemple suivant crée une colonne calculée.

private void AddDataColumn(DataTable table)
{
    System.Type decimalType;
    decimalType = System.Type.GetType("System.Decimal");

    // Create the column. The name is 'Tax,' with data type Decimal,and
    // an expression ('UnitPrice * .0862) to calculate the tax.
    DataColumn column = new DataColumn("Tax",
        decimalType, "UnitPrice * .0862");

    // Set various properties.
    column.AutoIncrement = false;
    column.ReadOnly = true;

    // Add to Columns collection.;
    table.Columns.Add(column);
}
Private Sub AddDataColumn(ByVal table As DataTable)
    Dim column As DataColumn 
    Dim decimalType As System.Type
 
    decimalType = System.Type.GetType("System.Decimal")
    column = New DataColumn("Tax", decimalType, "UnitPrice * .0862")

    ' Set various properties.
    With column
       .AutoIncrement = False
       .ReadOnly = True
    End With

    ' Add to Columns collection.
    table.Columns.Add(column)
 End Sub

Voir aussi

S’applique à

DataColumn(String, Type, String, MappingType)

Source:
DataColumn.cs
Source:
DataColumn.cs
Source:
DataColumn.cs

Initialise une nouvelle instance de la classe DataColumn à l'aide du nom, du type de données et de l'expression spécifiés, ainsi que d'une valeur qui détermine si la colonne est un attribut.

public:
 DataColumn(System::String ^ columnName, Type ^ dataType, System::String ^ expr, System::Data::MappingType type);
public DataColumn (string? columnName, Type dataType, string? expr, System.Data.MappingType type);
public DataColumn (string columnName, Type dataType, string expr, System.Data.MappingType type);
new System.Data.DataColumn : string * Type * string * System.Data.MappingType -> System.Data.DataColumn
Public Sub New (columnName As String, dataType As Type, expr As String, type As MappingType)

Paramètres

columnName
String

Chaîne qui représente le nom de la colonne à créer. Si sa valeur est null ou une chaîne vide (""), un nom par défaut est spécifié lors de son ajout à la collection de colonnes.

dataType
Type

DataType pris en charge.

expr
String

Expression utilisée pour créer cette colonne. Pour plus d'informations, consultez la propriété Expression.

type
MappingType

Une des valeurs de l'objet MappingType.

Exceptions

Aucun dataType n'est spécifié.

Exemples

L’exemple suivant construit une colonne calculée.

private void CreateComputedColumn(DataTable table)
{
    System.Type myDataType =
        System.Type.GetType("System.Decimal");

    // The expression multiplies the "Price" column value
    // by the "Quantity" to create the "Total" column.
    string expression = "Price * Quantity";

    // Create the column, setting the type to Attribute.
    DataColumn column = new DataColumn("Total", myDataType,
        expression, MappingType.Attribute);

    // Set various properties.
    column.AutoIncrement = false;
    column.ReadOnly = true;

    // Add the column to a DataTable object's to DataColumnCollection.
    DataSet1.Tables["OrderDetails"].Columns.Add(column);
}
Private Sub CreateComputedColumn(ByVal table As DataTable)
    Dim column As DataColumn
    Dim decimalType As System.Type = _
        System.Type.GetType("System.Decimal")

    ' The expression multiplies the "Price" column value by the 
    ' "Quantity" to create the "Total" column.
    Dim expression As String = "Price * Quantity"

    ' Create the column, setting the type to Attribute.
    column = New DataColumn("Total", decimalType, _
        expression, MappingType.Attribute)

    ' Set various properties.
    column.AutoIncrement = False
    column.ReadOnly = True

    ' Add the column to a DataTable object's DataColumnCollection.
    DataSet1.Tables("OrderDetails").Columns.Add(column)
End Sub

Remarques

L’argument type définit la ColumnMapping propriété . La propriété spécifie la façon dont un DataColumn est mappé lorsqu’un DataSet est transformé en document XML. Par exemple, si la colonne est nommée « fName » et que la valeur qu’elle contient est « Bob » et type est définie sur MappingType.Attribute, l’élément XML se présente comme suit :

<Nom fName = 'Bob'/>

Pour plus d’informations sur la façon dont les colonnes sont mappées à des éléments ou des attributs, consultez la ColumnMapping propriété .

Voir aussi

S’applique à