DataColumnCollection.Add Methode

Definition

Erstellt ein DataColumn-Objekt und fügt dieses der DataColumnCollection hinzu.Creates and adds a DataColumn object to the DataColumnCollection.

Überlädt

Add()

Erstellt ein DataColumn-Objekt und fügt dieses der DataColumnCollection hinzu.Creates and adds a DataColumn object to the DataColumnCollection.

Add(DataColumn)

Erstellt das angegebene DataColumn-Objekt und fügt dieses der DataColumnCollection hinzu.Creates and adds the specified DataColumn object to the DataColumnCollection.

Add(String)

Erstellt ein DataColumn-Objekt mit dem angegebenen Namen und fügt dieses der DataColumnCollection hinzu.Creates and adds a DataColumn object that has the specified name to the DataColumnCollection.

Add(String, Type)

Erstellt ein DataColumn-Objekt mit dem angegebenen Namen und Typ und fügt dieses der DataColumnCollection hinzu.Creates and adds a DataColumn object that has the specified name and type to the DataColumnCollection.

Add(String, Type, String)

Erstellt ein DataColumn-Objekt mit dem angegebenen Namen, Typ und Ausdruck und fügt dieses der DataColumnCollection hinzu.Creates and adds a DataColumn object that has the specified name, type, and expression to the DataColumnCollection.

Add()

Erstellt ein DataColumn-Objekt und fügt dieses der DataColumnCollection hinzu.Creates and adds a DataColumn object to the DataColumnCollection.

public:
 virtual System::Data::DataColumn ^ Add();
public virtual System.Data.DataColumn Add ();
abstract member Add : unit -> System.Data.DataColumn
override this.Add : unit -> System.Data.DataColumn
Public Overridable Function Add () As DataColumn

Gibt zurück

Der neu erstellte DataColumn.The newly created DataColumn.

Beispiele

Im folgenden Beispiel wird ein neues DataColumn DataColumnCollection DataTableerstellt und einem hinzugefügt.The following example creates and adds a new DataColumn to the DataColumnCollection of a 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

Hinweise

Der Spalte wird ein Standardname ("Column1", "Column2" usw.) zugewiesen.A default name ("Column1", "Column2", and so on) is given to the column.

Wenn die Auflistung durch Hinzufügen oder Entfernen von Spalten erfolgreich geändert wird CollectionChanged , tritt das-Ereignis auf.If the collection is successfully changed by adding or removing columns, the CollectionChanged event occurs.

Siehe auch

Add(DataColumn)

Erstellt das angegebene DataColumn-Objekt und fügt dieses der DataColumnCollection hinzu.Creates and adds the specified DataColumn object to the 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)

Parameter

column
DataColumn

Das hinzuzufügende DataColumn.The DataColumn to add.

Ausnahmen

Der column-Parameter ist null.The column parameter is null.

Die Spalte gehört bereits zu dieser Auflistung, oder sie gehört zu einer anderen Auflistung.The column already belongs to this collection, or to another collection.

Die Auflistung enthält bereits eine Spalte mit dem angegebenen Namen.The collection already has a column with the specified name. (Beim Vergleich wird die Groß-/Kleinschreibung nicht berücksichtigt.)(The comparison is not case-sensitive.)

Der Ausdruck ist ungültig.The expression is invalid. Weitere Informationen zum Erstellen von Ausdrücken finden Sie unter der Expression-Eigenschaft.See the Expression property for more information about how to create expressions.

Beispiele

Im folgenden Beispiel wird ein DataColumn hinzugefügt DataColumnCollection.The following example adds a DataColumn to a 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

Hinweise

Wenn die Auflistung durch Hinzufügen oder Entfernen von Spalten erfolgreich geändert wird CollectionChanged , tritt das-Ereignis auf.If the collection is successfully changed by adding or removing columns, the CollectionChanged event occurs.

Siehe auch

Add(String)

Erstellt ein DataColumn-Objekt mit dem angegebenen Namen und fügt dieses der DataColumnCollection hinzu.Creates and adds a DataColumn object that has the specified name to the DataColumnCollection.

public:
 virtual System::Data::DataColumn ^ Add(System::String ^ columnName);
public virtual System.Data.DataColumn Add (string columnName);
abstract member Add : string -> System.Data.DataColumn
override this.Add : string -> System.Data.DataColumn
Public Overridable Function Add (columnName As String) As DataColumn

Parameter

columnName
String

Der Name der Spalte.The name of the column.

Gibt zurück

Der neu erstellte DataColumn.The newly created DataColumn.

Ausnahmen

Die Auflistung enthält bereits eine Spalte mit dem angegebenen Namen.The collection already has a column with the specified name. (Beim Vergleich wird die Groß-/Kleinschreibung nicht berücksichtigt.)(The comparison is not case-sensitive.)

Beispiele

Im folgenden Beispiel wird ein neues DataColumn DataColumnCollection DataTableerstellt und einem hinzugefügt.The following example creates and adds a new DataColumn to a DataColumnCollection of a 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

Hinweise

Standardmäßig ist stringder DataType für die neue Spalte.By default, the DataType for the new column is string.

Wenn null oder eine leere Zeichenfolge ("") für den Namen übergeben wird, wird ein Standardname ("Column1", "Column2" usw.) für die Spalte angegeben.If null or an empty string ("") is passed in for the name, a default name ("Column1", "Column2", and so on) is given to the column.

Verwenden Sie Contains die-Methode, um zu bestimmen, ob eine Spalte mit dem vorgeschlagenen Namen bereits in der Auflistung vorhanden ist.Use the Contains method to determine whether a column with the proposed name already exists in the collection.

Wenn die Auflistung durch Hinzufügen oder Entfernen von Spalten erfolgreich geändert wird CollectionChanged , tritt das-Ereignis auf.If the collection is successfully changed by adding or removing columns, the CollectionChanged event occurs.

Siehe auch

Add(String, Type)

Erstellt ein DataColumn-Objekt mit dem angegebenen Namen und Typ und fügt dieses der DataColumnCollection hinzu.Creates and adds a DataColumn object that has the specified name and type to the DataColumnCollection.

public:
 virtual System::Data::DataColumn ^ Add(System::String ^ columnName, Type ^ type);
public virtual System.Data.DataColumn Add (string columnName, Type type);
abstract member Add : string * Type -> System.Data.DataColumn
override this.Add : string * Type -> System.Data.DataColumn

Parameter

columnName
String

Der beim Erstellen der Spalte zu verwendende ColumnName.The ColumnName to use when you create the column.

type
Type

Der DataType der neuen Spalte.The DataType of the new column.

Gibt zurück

Der neu erstellte DataColumn.The newly created DataColumn.

Ausnahmen

Die Auflistung enthält bereits eine Spalte mit dem angegebenen Namen.The collection already has a column with the specified name. (Beim Vergleich wird die Groß-/Kleinschreibung nicht berücksichtigt.)(The comparison is not case-sensitive.)

Der Ausdruck ist ungültig.The expression is invalid. Weitere Informationen zum Erstellen von Ausdrücken finden Sie unter der Expression-Eigenschaft.See the Expression property for more information about how to create expressions.

Beispiele

Im folgenden Beispiel wird ein neues DataColumn DataColumnCollection DataTableerstellt und einem hinzugefügt.The following example creates and adds a new DataColumn to a DataColumnCollection of a 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

Hinweise

Wenn null oder eine leere Zeichenfolge ("") für den Namen übergeben wird, wird ein Standardname ("Column1", "Column2" usw.) für die Spalte angegeben.If null or an empty string ("") is passed in for the name, a default name ("Column1", "Column2", and so on) is given to the column.

Verwenden Sie Contains die-Methode, um zu bestimmen, ob eine Spalte mit dem vorgeschlagenen Namen bereits in der Auflistung vorhanden ist.Use the Contains method to determine whether a column with the proposed name already exists in the collection.

Wenn die Auflistung durch Hinzufügen oder Entfernen von Spalten erfolgreich geändert wird CollectionChanged , tritt das-Ereignis auf.If the collection is successfully changed by adding or removing columns, the CollectionChanged event occurs.

Siehe auch

Add(String, Type, String)

Erstellt ein DataColumn-Objekt mit dem angegebenen Namen, Typ und Ausdruck und fügt dieses der DataColumnCollection hinzu.Creates and adds a DataColumn object that has the specified name, type, and expression to the DataColumnCollection.

public:
 virtual System::Data::DataColumn ^ Add(System::String ^ columnName, Type ^ type, System::String ^ expression);
public virtual System.Data.DataColumn Add (string columnName, Type type, string expression);
abstract member Add : string * Type * string -> System.Data.DataColumn
override this.Add : string * Type * string -> System.Data.DataColumn

Parameter

columnName
String

Der beim Erstellen der Spalte zu verwendende Name.The name to use when you create the column.

type
Type

Der DataType der neuen Spalte.The DataType of the new column.

expression
String

Der Ausdruck, der der Expression-Eigenschaft zugewiesen werden soll.The expression to assign to the Expression property.

Gibt zurück

Der neu erstellte DataColumn.The newly created DataColumn.

Ausnahmen

Die Auflistung enthält bereits eine Spalte mit dem angegebenen Namen.The collection already has a column with the specified name. (Beim Vergleich wird die Groß-/Kleinschreibung nicht berücksichtigt.)(The comparison is not case-sensitive.)

Der Ausdruck ist ungültig.The expression is invalid. Weitere Informationen zum Erstellen von Ausdrücken finden Sie unter der Expression-Eigenschaft.See the Expression property for more information about how to create expressions.

Beispiele

Im folgenden Beispiel wird ein neues DataColumn DataColumnCollection DataTableerstellt und einem hinzugefügt.The following example creates and adds a new DataColumn to a DataColumnCollection of a 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

Hinweise

Wenn null oder eine leere Zeichenfolge ("") für den Namen übergeben wird, wird ein Standardname ("Column1", "Column2" usw.) für die Spalte angegeben.If null or an empty string ("") is passed in for the name, a default name ("Column1", "Column2", and so on) is given to the column.

Verwenden Sie Contains die-Methode, um zu bestimmen, ob eine Spalte mit dem vorgeschlagenen Namen bereits in der Auflistung vorhanden ist.Use the Contains method to determine whether a column with the proposed name already exists in the collection.

Wenn die Auflistung durch Hinzufügen oder Entfernen von Spalten erfolgreich geändert wird CollectionChanged , tritt das-Ereignis auf.If the collection is successfully changed by adding or removing columns, the CollectionChanged event occurs.

Siehe auch

Gilt für: