DataColumn Costruttori

Definizione

Spazio dei nomi:

System.Data

Assembly:

netstandard.dll, System.Data.Common.dll

Inizializza una nuova istanza della classe DataColumn.

Overload

Nome	Descrizione
DataColumn()	Inizializza una nuova istanza della DataColumn classe come stringa di tipo.
DataColumn(String)	Inizializza una nuova istanza della DataColumn classe, come stringa di tipo, utilizzando il nome di colonna specificato.
DataColumn(String, Type)	Inizializza una nuova istanza della DataColumn classe utilizzando il nome della colonna e il tipo di dati specificati.
DataColumn(String, Type, String)	Inizializza una nuova istanza della DataColumn classe utilizzando il nome, il tipo di dati e l'espressione specificati.
DataColumn(String, Type, String, MappingType)	Inizializza una nuova istanza della DataColumn classe utilizzando il nome, il tipo di dati, l'espressione e il valore specificati che determina se la colonna è un attributo.

DataColumn()

Origine:

DataColumn.cs

Inizializza una nuova istanza della DataColumn classe come stringa di tipo.

public:
 DataColumn();

public DataColumn();

Public Sub New ()

Esempio

Nell'esempio seguente viene creato un nuovo DataColumnoggetto , vengono impostate varie proprietà e vengono aggiunte a un DataColumnCollection oggetto per l'oggetto 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

Commenti

Al momento della creazione, un DataColumn oggetto non ha un valore predefinito ColumnName o Caption. Quando lo si aggiunge a , DataColumnCollectionverrà generato un nome predefinito ("Column1", "Column2" e così via) se un nome non è stato assegnato a ColumnName.

Vedi anche

• ColumnName
• Caption
• DefaultValue
• DataTable
• DataType
• Uso di DataSet in ADO.NET

DataColumn(String)

Origine:

DataColumn.cs

Inizializza una nuova istanza della DataColumn classe, come stringa di tipo, utilizzando il nome di colonna specificato.

public:
 DataColumn(System::String ^ columnName);

public DataColumn(string? columnName);

new System.Data.DataColumn : string -> System.Data.DataColumn

Public Sub New (columnName As String)

Parametri

columnName

String

Stringa che rappresenta il nome della colonna da creare. Se impostato su null o su una stringa vuota (""), verrà specificato un nome predefinito quando viene aggiunto all'insieme columns.

Esempio

Nell'esempio seguente viene creato un nuovo DataColumn oggetto con un oggetto specificato 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

Commenti

Per impostazione predefinita, il nome specifico di una colonna diventa il valore della Caption proprietà.

Vedi anche

• ColumnName
• Caption
• DefaultValue
• DataTable
• DataType
• Uso di DataSet in ADO.NET

DataColumn(String, Type)

Origine:

DataColumn.cs

Inizializza una nuova istanza della DataColumn classe utilizzando il nome della colonna e il tipo di dati specificati.

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)

Parametri

columnName

String

Stringa che rappresenta il nome della colonna da creare. Se impostato su null o su una stringa vuota (""), verrà specificato un nome predefinito quando viene aggiunto all'insieme columns.

dataType

Type

Oggetto supportato DataType.

Eccezioni

ArgumentNullException

Non è stato specificato alcun dataType valore.

Esempio

Nell'esempio seguente viene creato un nuovo DataColumn oggetto con un oggetto specificato ColumnName e 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

Vedi anche

• DefaultValue
• ColumnName
• Caption
• DataTable
• DataType
• Uso di DataSet in ADO.NET

DataColumn(String, Type, String)

Origine:

DataColumn.cs

Inizializza una nuova istanza della DataColumn classe utilizzando il nome, il tipo di dati e l'espressione specificati.

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)

Parametri

columnName

String

Stringa che rappresenta il nome della colonna da creare. Se impostato su null o su una stringa vuota (""), verrà specificato un nome predefinito quando viene aggiunto all'insieme columns.

dataType

Type

Oggetto supportato DataType.

expr

String

Espressione utilizzata per creare questa colonna. Per ulteriori informazioni, consultare la proprietà Expression.

Attributi

RequiresUnreferencedCodeAttribute

Eccezioni

ArgumentNullException

Non è stato specificato alcun dataType valore.

Esempio

Nell'esempio seguente viene creata una colonna calcolata.

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

Vedi anche

• DefaultValue
• ColumnName
• Caption
• DataTable
• DataType
• Expression
• Uso di DataSet in ADO.NET

DataColumn(String, Type, String, MappingType)

Origine:

DataColumn.cs

Inizializza una nuova istanza della DataColumn classe utilizzando il nome, il tipo di dati, l'espressione e il valore specificati che determina se la colonna è un attributo.

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)

Parametri

columnName

String

Stringa che rappresenta il nome della colonna da creare. Se impostato su null o su una stringa vuota (""), verrà specificato un nome predefinito quando viene aggiunto all'insieme columns.

dataType

Type

Oggetto supportato DataType.

expr

String

Espressione utilizzata per creare questa colonna. Per ulteriori informazioni, consultare la proprietà Expression.

type

MappingType

Uno dei MappingType valori.

Attributi

RequiresUnreferencedCodeAttribute

Eccezioni

ArgumentNullException

Non è stato specificato alcun dataType valore.

Esempio

Nell'esempio seguente viene creata una colonna calcolata.

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

Commenti

L'argomento type imposta la ColumnMapping proprietà . La proprietà specifica la modalità di mapping di un DataColumn oggetto quando un oggetto DataSet viene trasformato in un documento XML. Ad esempio, se la colonna è denominata "fName" e il valore che contiene è "Bob" ed type è impostato su MappingType.Attribute, l'elemento XML sarà il seguente:

<Nome fName = 'Bob'/>

Per altre informazioni sul mapping delle colonne a elementi o attributi, vedere la ColumnMapping proprietà .

Vedi anche

• ColumnName
• ColumnMapping
• Caption
• DefaultValue
• DataTable
• DataType
• Uso di DataSet in ADO.NET