DataColumnCollection.Add Metoda

  • Reference

Definice

Obor názvů:
System.Data
Sestavení:
System.Data.Common.dll
Sestavení:
System.Data.dll
Sestavení:
netstandard.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
Zdroj:
DataColumnCollection.cs
Zdroj:
DataColumnCollection.cs

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

public:
 System::Data::DataColumn ^ Add();
public:
 virtual System::Data::DataColumn ^ Add();
public System.Data.DataColumn Add ();
public virtual System.Data.DataColumn Add ();
member this.Add : unit -> System.Data.DataColumn
abstract member Add : unit -> System.Data.DataColumn
override this.Add : unit -> System.Data.DataColumn
Public Function Add () As DataColumn
Public Overridable 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é

Platí pro

Add(DataColumn)

Zdroj:
DataColumnCollection.cs
Zdroj:
DataColumnCollection.cs
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é

Platí pro

Add(String)

Zdroj:
DataColumnCollection.cs
Zdroj:
DataColumnCollection.cs
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:
 virtual System::Data::DataColumn ^ Add(System::String ^ columnName);
public System.Data.DataColumn Add (string? columnName);
public System.Data.DataColumn Add (string columnName);
public virtual System.Data.DataColumn Add (string columnName);
member this.Add : string -> System.Data.DataColumn
abstract member Add : string -> System.Data.DataColumn
override this.Add : string -> System.Data.DataColumn
Public Function Add (columnName As String) As DataColumn
Public Overridable 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é

Platí pro

Add(String, Type)

Zdroj:
DataColumnCollection.cs
Zdroj:
DataColumnCollection.cs
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:
 virtual System::Data::DataColumn ^ Add(System::String ^ columnName, Type ^ type);
public System.Data.DataColumn Add (string? columnName, Type type);
public System.Data.DataColumn Add (string columnName, Type type);
public virtual System.Data.DataColumn Add (string columnName, Type type);
member this.Add : string * Type -> System.Data.DataColumn
abstract member Add : string * Type -> System.Data.DataColumn
override this.Add : string * Type -> System.Data.DataColumn
Public Function Add (columnName As String, type As Type) As DataColumn
Public Overridable 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é

Platí pro

Add(String, Type, String)

Zdroj:
DataColumnCollection.cs
Zdroj:
DataColumnCollection.cs
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:
 virtual System::Data::DataColumn ^ Add(System::String ^ columnName, Type ^ type, System::String ^ expression);
public System.Data.DataColumn Add (string? columnName, Type type, string expression);
public System.Data.DataColumn Add (string columnName, Type type, string expression);
public virtual System.Data.DataColumn Add (string columnName, Type type, string expression);
member this.Add : string * Type * string -> System.Data.DataColumn
abstract member Add : string * Type * string -> System.Data.DataColumn
override this.Add : string * Type * string -> System.Data.DataColumn
Public Function Add (columnName As String, type As Type, expression As String) As DataColumn
Public Overridable 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é

Platí pro