DataColumn Konstruktory

Definice

Obor názvů:

System.Data

Sestavení:

netstandard.dll, System.Data.Common.dll

Inicializuje novou instanci DataColumn třídy.

Přetížení

Name	Description
DataColumn()	Inicializuje novou instanci DataColumn třídy jako typ řetězec.
DataColumn(String)	Inicializuje novou instanci DataColumn třídy jako řetězec typu pomocí zadaného názvu sloupce.
DataColumn(String, Type)	Inicializuje novou instanci třídy pomocí zadaného DataColumn názvu sloupce a datového typu.
DataColumn(String, Type, String)	Inicializuje novou instanci třídy pomocí zadaného názvu, datového DataColumn typu a výrazu.
DataColumn(String, Type, String, MappingType)	Inicializuje novou instanci třídy pomocí zadaného názvu, datového DataColumn typu, výrazu a hodnoty, která určuje, zda sloupec je atribut.

DataColumn()

Zdroj:

DataColumn.cs

Inicializuje novou instanci DataColumn třídy jako typ řetězec.

public:
 DataColumn();

public DataColumn();

Public Sub New ()

Příklady

Následující příklad vytvoří novou DataColumn, nastaví různé vlastnosti a přidá ho do objektu DataColumnCollectionDataTable .

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

Poznámky

Při vytváření DataColumn objekt nemá výchozí hodnotu ColumnName nebo Caption. Když ho přidáte do DataColumnCollection, výchozí název ("Sloupec1", "Sloupec2" atd.) se vygeneruje, pokud nebyl přiřazen ColumnNamenázev .

Viz také

• ColumnName
• Caption
• DefaultValue
• DataTable
• DataType
• Použití datových sad v ADO.NET

DataColumn(String)

Zdroj:

DataColumn.cs

Inicializuje novou instanci DataColumn třídy jako řetězec typu pomocí zadaného názvu sloupce.

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

public DataColumn(string? columnName);

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

Public Sub New (columnName As String)

Parametry

columnName

String

Řetězec, který představuje název sloupce, který se má vytvořit. Pokud je null nastaven nebo prázdný řetězec (""), bude při přidání do kolekce sloupců zadán výchozí název.

Příklady

Následující příklad vytvoří nový DataColumn se zadaným 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

Poznámky

Ve výchozím nastavení se název specifický pro sloupec stane Caption hodnotou vlastnosti.

Viz také

• ColumnName
• Caption
• DefaultValue
• DataTable
• DataType
• Použití datových sad v ADO.NET

DataColumn(String, Type)

Zdroj:

DataColumn.cs

Inicializuje novou instanci třídy pomocí zadaného DataColumn názvu sloupce a datového typu.

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)

Parametry

columnName

String

Řetězec, který představuje název sloupce, který se má vytvořit. Pokud je null nastaven nebo prázdný řetězec (""), bude při přidání do kolekce sloupců zadán výchozí název.

dataType

Type

Podporováno DataType.

Výjimky

ArgumentNullException

Nebyla zadána žádná dataType .

Příklady

Následující příklad vytvoří nový DataColumn se zadaným ColumnName a 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

Viz také

• DefaultValue
• ColumnName
• Caption
• DataTable
• DataType
• Použití datových sad v ADO.NET

DataColumn(String, Type, String)

Zdroj:

DataColumn.cs

Inicializuje novou instanci třídy pomocí zadaného názvu, datového DataColumn typu a výrazu.

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)

Parametry

columnName

String

Řetězec, který představuje název sloupce, který se má vytvořit. Pokud je null nastaven nebo prázdný řetězec (""), bude při přidání do kolekce sloupců zadán výchozí název.

dataType

Type

Podporováno DataType.

expr

String

Výraz použitý k vytvoření tohoto sloupce. Další informace najdete ve vlastnosti Expression.

Atributy

RequiresUnreferencedCodeAttribute

Výjimky

ArgumentNullException

Nebyla zadána žádná dataType .

Příklady

Následující příklad vytvoří počítaný sloupec.

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

Viz také

• DefaultValue
• ColumnName
• Caption
• DataTable
• DataType
• Expression
• Použití datových sad v ADO.NET

DataColumn(String, Type, String, MappingType)

Zdroj:

DataColumn.cs

Inicializuje novou instanci třídy pomocí zadaného názvu, datového DataColumn typu, výrazu a hodnoty, která určuje, zda sloupec je atribut.

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)

Parametry

columnName

String

Řetězec, který představuje název sloupce, který se má vytvořit. Pokud je null nastaven nebo prázdný řetězec (""), bude při přidání do kolekce sloupců zadán výchozí název.

dataType

Type

Podporováno DataType.

expr

String

Výraz použitý k vytvoření tohoto sloupce. Další informace najdete ve vlastnosti Expression.

type

MappingType

Jedna z MappingType hodnot.

Atributy

RequiresUnreferencedCodeAttribute

Výjimky

ArgumentNullException

Nebyla zadána žádná dataType .

Příklady

Následující příklad vytvoří vypočítaný sloupec.

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

Poznámky

Argument type nastaví ColumnMapping vlastnost. Vlastnost určuje, jak DataColumn se mapuje při DataSet transformaci do dokumentu XML. Pokud má například sloupec název "fName", a hodnota, která obsahuje, je "Bob", a type je nastavena na MappingType.Attribute, element XML by byl následující:

<Name fName = 'Bob'/>

Další informace o tom, jak jsou sloupce mapovány na prvky nebo atributy, naleznete v ColumnMapping vlastnosti.

Viz také

• ColumnName
• ColumnMapping
• Caption
• DefaultValue
• DataTable
• DataType
• Použití datových sad v ADO.NET