DataColumnCollection.Add Metoda

Definice

Obor názvů:

System.Data

Sestavení:

netstandard.dll, System.Data.Common.dll

Vytvoří a přidá DataColumn objekt do objektu DataColumnCollection.

Přetížení

Name	Description
Add()	Vytvoří a přidá DataColumn objekt do objektu DataColumnCollection.
Add(DataColumn)	Vytvoří a přidá zadaný DataColumn objekt do objektu DataColumnCollection.
Add(String)	Vytvoří a přidá DataColumn objekt, který má zadaný název do objektu DataColumnCollection.
Add(String, Type)	Vytvoří a přidá DataColumn objekt, který má zadaný název a typ do objektu DataColumnCollection.
Add(String, Type, String)	Vytvoří a přidá DataColumn objekt, který má zadaný název, typ a výraz do objektu DataColumnCollection.

Add()

Zdroj:

DataColumnCollection.cs

Vytvoří a přidá DataColumn objekt do objektu DataColumnCollection.

public:
 System::Data::DataColumn ^ Add();

public System.Data.DataColumn Add();

member this.Add : unit -> System.Data.DataColumn

Public Function Add () As DataColumn

Návraty

DataColumn

Nově vytvořený DataColumn.

Příklady

Následující příklad vytvoří a přidá nové DataColumn do DataColumnCollection souboru DataTable.

Private Sub AddColumn()
    ' Get the DataColumnCollection from a table in a DataSet.
    Dim columns As DataColumnCollection = _
        DataSet1.Tables("Prices").Columns
    Dim column As DataColumn = columns.Add()

    With column
       .DataType = System.Type.GetType("System.Decimal")
       .ColumnName = "Total"
       .Expression = "UnitPrice * Quantity"
       .ReadOnly = True
       .Unique = False
    End With
End Sub

Poznámky

Sloupec má výchozí název (Sloupec1, Sloupec2 atd.).

Pokud se kolekce úspěšně změní přidáním nebo odebráním sloupců, dojde k CollectionChanged události.

Viz také

• ColumnName
• Contains(String)
• DataType
• Expression

Add(DataColumn)

Zdroj:

DataColumnCollection.cs

Vytvoří a přidá zadaný DataColumn objekt do objektu DataColumnCollection.

public:
 void Add(System::Data::DataColumn ^ column);

public void Add(System.Data.DataColumn column);

member this.Add : System.Data.DataColumn -> unit

Public Sub Add (column As DataColumn)

Parametry

column

DataColumn

Přidání DataColumn

Výjimky

ArgumentNullException

Parametr column je null.

ArgumentException

Sloupec již patří do této kolekce nebo do jiné kolekce.

DuplicateNameException

Kolekce již obsahuje sloupec se zadaným názvem. (Porovnání nerozlišuje malá a velká písmena.)

InvalidExpressionException

Výraz je neplatný. Další informace o tom, jak vytvářet výrazy, najdete v Expression této vlastnosti.

Příklady

Následující příklad přidá do DataColumn .DataColumnCollection

Private Sub AddDataColumn()
    ' Get the DataColumnCollection from a DataTable in a DataSet.
    Dim columns As DataColumnCollection = _
        DataSet1.Tables("Orders").Columns
 
    Dim column As New DataColumn()
    With column
       .DataType = System.Type.GetType("System.Decimal")
       .ColumnName = "ItemPrice"
       .Caption = "Price"
       .ReadOnly = False
       .Unique = False
       .DefaultValue = 0
    End With
    columns.Add(column)
End Sub

Poznámky

Pokud se kolekce úspěšně změní přidáním nebo odebráním sloupců, dojde k CollectionChanged události.

Viz také

• ColumnName
• CollectionChanged
• Contains(String)
• DataType
• Expression

Add(String)

Zdroj:

DataColumnCollection.cs

Vytvoří a přidá DataColumn objekt, který má zadaný název do objektu DataColumnCollection.

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

public System.Data.DataColumn Add(string? columnName);

member this.Add : string -> System.Data.DataColumn

Public Function Add (columnName As String) As DataColumn

Parametry

columnName

String

Název sloupce.

Návraty

DataColumn

Nově vytvořený DataColumn.

Výjimky

DuplicateNameException

Kolekce již obsahuje sloupec se zadaným názvem. (Porovnání nerozlišuje malá a velká písmena.)

Příklady

Následující příklad vytvoří a přidá nový DataColumn do souboru DataColumnCollectionDataTable.

Private Sub AddColumn()
    ' Get the DataColumnCollection from a table in a DataSet.
    Dim columns As DataColumnCollection = _
        DataSet1.Tables("Prices").Columns
    Dim column As DataColumn = columns.Add("Total")

    With column
       .DataType = System.Type.GetType("System.Decimal")
       .ReadOnly = True
       .Expression = "UnitPrice * Quantity"
       .Unique = False
    End With
End Sub

Poznámky

Ve výchozím nastavení DataType je stringnový sloupec .

Pokud null se pro název předá prázdný řetězec ("") výchozí název ("Column1", "Column2" atd.) se do sloupce dostane.

Použijte metodu Contains k určení, zda sloupec s navrhovaným názvem již v kolekci existuje.

Pokud se kolekce úspěšně změní přidáním nebo odebráním sloupců, dojde k CollectionChanged události.

Viz také

• ColumnName
• Contains(String)
• DataType
• Expression

Add(String, Type)

Zdroj:

DataColumnCollection.cs

Vytvoří a přidá DataColumn objekt, který má zadaný název a typ do objektu DataColumnCollection.

public:
 System::Data::DataColumn ^ Add(System::String ^ columnName, Type ^ type);

public System.Data.DataColumn Add(string? columnName, Type type);

member this.Add : string * Type -> System.Data.DataColumn

Public Function Add (columnName As String, type As Type) As DataColumn

Parametry

columnName

String

Použije ColumnName se při vytváření sloupce.

type

Type

Nový DataType sloupec.

Návraty

DataColumn

Nově vytvořený DataColumn.

Výjimky

DuplicateNameException

Kolekce již obsahuje sloupec se zadaným názvem. (Porovnání nerozlišuje malá a velká písmena.)

InvalidExpressionException

Výraz je neplatný. Další informace o tom, jak vytvářet výrazy, najdete v Expression této vlastnosti.

Příklady

Následující příklad vytvoří a přidá nový DataColumn do souboru DataColumnCollectionDataTable.

Private Sub AddColumn()
    Dim columns As DataColumnCollection = _
        DataSet1.Tables("Orders").Columns
 
    ' Add a new column and return it.
    Dim column As DataColumn = columns.Add( _
        "Total", System.Type.GetType("System.Decimal"))
    column.ReadOnly = True
    column.Unique = False
End Sub

Poznámky

Pokud null se pro název předá prázdný řetězec ("") výchozí název ("Column1", "Column2" atd.) se do sloupce dostane.

Použijte metodu Contains k určení, zda sloupec s navrhovaným názvem již v kolekci existuje.

Pokud se kolekce úspěšně změní přidáním nebo odebráním sloupců, dojde k CollectionChanged události.

Viz také

• ColumnName
• DataType
• Expression

Add(String, Type, String)

Zdroj:

DataColumnCollection.cs

Vytvoří a přidá DataColumn objekt, který má zadaný název, typ a výraz do objektu DataColumnCollection.

public:
 System::Data::DataColumn ^ Add(System::String ^ columnName, Type ^ type, System::String ^ expression);

[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Members might be trimmed for some data types or expressions.")]
public System.Data.DataColumn Add(string? columnName, Type type, string expression);

[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Members might be trimmed for some data types or expressions.")>]
member this.Add : string * Type * string -> System.Data.DataColumn

Public Function Add (columnName As String, type As Type, expression As String) As DataColumn

Parametry

columnName

String

Název, který se má použít při vytváření sloupce.

type

Type

Nový DataType sloupec.

expression

String

Výraz, který se má přiřadit k Expression vlastnosti.

Návraty

DataColumn

Nově vytvořený DataColumn.

Atributy

RequiresUnreferencedCodeAttribute

Výjimky

DuplicateNameException

Kolekce již obsahuje sloupec se zadaným názvem. (Porovnání nerozlišuje malá a velká písmena.)

InvalidExpressionException

Výraz je neplatný. Další informace o tom, jak vytvářet výrazy, najdete v Expression této vlastnosti.

Příklady

Následující příklad vytvoří a přidá nový DataColumn do souboru DataColumnCollectionDataTable.

Private Sub AddColumn()
    ' Get the DataColumnCollection of a table in a DataSet.
    Dim columns As DataColumnCollection = _
        DataSet1.Tables("Orders").Columns

    ' Add a new column and return it.
    Dim column As DataColumn = _
        columns.Add("Total", System.Type.GetType( _
        "System.Decimal"), "Price + Tax")
    column.ReadOnly = True
    column.Unique = False
 End Sub

Poznámky

Pokud null se pro název předá prázdný řetězec ("") výchozí název ("Column1", "Column2" atd.) se do sloupce dostane.

Použijte metodu Contains k určení, zda sloupec s navrhovaným názvem již v kolekci existuje.

Pokud se kolekce úspěšně změní přidáním nebo odebráním sloupců, dojde k CollectionChanged události.

Viz také

• ColumnName
• Contains(String)
• DataType
• Expression