DataColumnCollection.Add Metoda

Definice

Obor názvů:

System.Data

Sestavení:

System.Data.Common.dll

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

Přetížení

Add()	Vytvoří objekt a přidá ho DataColumn do objektu DataColumnCollection.
Add(DataColumn)	Vytvoří a přidá zadaný DataColumn objekt do objektu DataColumnCollection.
Add(String)	Vytvoří a přidá objekt se DataColumn zadaným názvem do objektu DataColumnCollection.
Add(String, Type)	Vytvoří a přidá DataColumn objekt se zadaným názvem a typem do objektu DataColumnCollection.
Add(String, Type, String)	Vytvoří a přidá objekt se DataColumn zadaným názvem, typem a výrazem do objektu DataColumnCollection.

Add()

Zdroj:

DataColumnCollection.cs

Vytvoří objekt a přidá ho DataColumn 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á položka DataColumn.

Příklady

Následující příklad vytvoří a přidá nový DataColumn do DataColumnCollection .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 ("Column1", "Column2" atd.).

Pokud je kolekce úspěšně změněna 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á DataColumn se.

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. (Při porovnávání se nerozlišují malá a velká písmena.)

InvalidExpressionException

Výraz je neplatný. Další informace o vytváření výrazů najdete ve Expression vlastnosti .

Příklady

Následující příklad přidá do DataColumnDataColumnCollection.

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 je kolekce úspěšně změněna 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á objekt se DataColumn zadaným názvem 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á položka DataColumn.

Výjimky

DuplicateNameException

Kolekce již obsahuje sloupec se zadaným názvem. (Při porovnávání se nerozlišují malá a velká písmena.)

Příklady

Následující příklad vytvoří a přidá nový DataColumn do DataColumnCollection .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("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 má stringnový sloupec hodnotu .

Pokud null se jako název předá nebo prázdný řetězec (""), předá se sloupci výchozí název ("Column1", "Column2" atd.).

Contains Pomocí metody zjistěte, jestli sloupec s navrhovaným názvem již existuje v kolekci.

Pokud je kolekce úspěšně změněna 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 se zadaným názvem a typem 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

Hodnota DataType nového sloupce.

Návraty

DataColumn

Nově vytvořená položka DataColumn.

Výjimky

DuplicateNameException

Kolekce již obsahuje sloupec se zadaným názvem. (Při porovnávání se nerozlišují malá a velká písmena.)

InvalidExpressionException

Výraz je neplatný. Další informace o vytváření výrazů najdete ve Expression vlastnosti .

Příklady

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

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 jako název předá nebo prázdný řetězec (""), předá se sloupci výchozí název ("Column1", "Column2" atd.).

Contains Pomocí metody zjistěte, jestli sloupec s navrhovaným názvem již existuje v kolekci.

Pokud je kolekce úspěšně změněna 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á objekt se DataColumn zadaným názvem, typem a výrazem do objektu DataColumnCollection.

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

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

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

Hodnota DataType nového sloupce.

expression

String

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

Návraty

DataColumn

Nově vytvořená položka DataColumn.

Výjimky

DuplicateNameException

Kolekce již obsahuje sloupec se zadaným názvem. (Při porovnávání se nerozlišují malá a velká písmena.)

InvalidExpressionException

Výraz je neplatný. Další informace o vytváření výrazů najdete ve Expression vlastnosti .

Příklady

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

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 jako název předá nebo prázdný řetězec (""), předá se sloupci výchozí název ("Column1", "Column2" atd.).

Contains Pomocí metody zjistěte, jestli sloupec s navrhovaným názvem již existuje v kolekci.

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

Viz také

• ColumnName
• Contains(String)
• DataType
• Expression