DataColumn Constructeurs

Définition

Espace de noms:

System.Data

Assemblys:

netstandard.dll, System.Data.Common.dll

Initialise une nouvelle instance de la classe DataColumn.

Surcharges

Nom	Description
DataColumn()	Initialise une nouvelle instance de la DataColumn classe en tant que chaîne de type.
DataColumn(String)	Initialise une nouvelle instance de la DataColumn classe, en tant que chaîne de type, à l’aide du nom de colonne spécifié.
DataColumn(String, Type)	Initialise une nouvelle instance de la DataColumn classe à 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 à l’aide du nom, du type de données et de l’expression DataColumn spécifiés.
DataColumn(String, Type, String, MappingType)	Initialise une nouvelle instance de la DataColumn classe à l’aide du nom, du type de données, de l’expression et de la valeur spécifiés qui détermine si la colonne est un attribut.

DataColumn()

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 DataColumnobjet , définit différentes propriétés et l’ajoute à un DataColumnCollection 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

Lors de la création, 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 », et ainsi de suite) est généré si un nom n’a pas été affecté à l’objet ColumnName.

Voir aussi

• ColumnName
• Caption
• DefaultValue
• DataTable
• DataType
• Utilisation de DataSets dans ADO.NET

DataColumn(String)

Source:

DataColumn.cs

Initialise une nouvelle instance de la DataColumn classe, en tant que chaîne de type, à l’aide du nom de colonne spécifié.

public:
 DataColumn(System::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 la valeur est définie null sur ou sur une chaîne vide (« »), un nom par défaut est spécifié lors de l’ajout à la collection de colonnes.

Exemples

L’exemple suivant crée un nouveau DataColumn avec un élément 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 Caption valeur de propriété.

Voir aussi

• ColumnName
• Caption
• DefaultValue
• DataTable
• DataType
• Utilisation de DataSets dans ADO.NET

DataColumn(String, Type)

Source:

DataColumn.cs

Initialise une nouvelle instance de la DataColumn classe à 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);

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 la valeur est définie null sur ou sur une chaîne vide (« »), un nom par défaut est spécifié lors de l’ajout à la collection de colonnes.

dataType

Type

Un . pris en charge DataType.

Exceptions

ArgumentNullException

Aucune n’a dataType été spécifiée.

Exemples

L’exemple suivant crée un nouveau DataColumn avec un élément 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

• DefaultValue
• ColumnName
• Caption
• DataTable
• DataType
• Utilisation de DataSets dans ADO.NET

DataColumn(String, Type, String)

Source:

DataColumn.cs

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

public:
 DataColumn(System::String ^ columnName, Type ^ dataType, System::String ^ expr);

[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Members from serialized types or types used in expressions may be trimmed if not referenced directly.")]
public DataColumn(string? columnName, Type dataType, string? expr);

[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Members from serialized types or types used in expressions may be trimmed if not referenced directly.")>]
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 la valeur est définie null sur ou sur une chaîne vide (« »), un nom par défaut est spécifié lors de l’ajout à la collection de colonnes.

dataType

Type

Un . pris en charge DataType.

expr

String

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

Attributs

RequiresUnreferencedCodeAttribute

Exceptions

ArgumentNullException

Aucune n’a dataType été spécifiée.

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

• DefaultValue
• ColumnName
• Caption
• DataTable
• DataType
• Expression
• Utilisation de DataSets dans ADO.NET

DataColumn(String, Type, String, MappingType)

Source:

DataColumn.cs

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

public:
 DataColumn(System::String ^ columnName, Type ^ dataType, System::String ^ expr, System::Data::MappingType type);

[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Members from serialized types or types used in expressions may be trimmed if not referenced directly.")]
public DataColumn(string? columnName, Type dataType, string? expr, System.Data.MappingType type);

[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Members from serialized types or types used in expressions may be trimmed if not referenced directly.")>]
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 la valeur est définie null sur ou sur une chaîne vide (« »), un nom par défaut est spécifié lors de l’ajout à la collection de colonnes.

dataType

Type

Un . pris en charge DataType.

expr

String

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

type

MappingType

Une des MappingType valeurs.

Attributs

RequiresUnreferencedCodeAttribute

Exceptions

ArgumentNullException

Aucune n’a dataType été spécifiée.

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 document XML est transformé. 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

• ColumnName
• ColumnMapping
• Caption
• DefaultValue
• DataTable
• DataType
• Utilisation de DataSets dans ADO.NET