DataColumnCollection.Add Methode

Definition

Erstellt ein DataColumn-Objekt und fügt dieses der DataColumnCollection hinzu.

Überlädt

Add()

Erstellt ein DataColumn-Objekt und fügt dieses der DataColumnCollection hinzu.

Add(DataColumn)

Erstellt das angegebene DataColumn-Objekt und fügt dieses der DataColumnCollection hinzu.

Add(String)

Erstellt ein DataColumn-Objekt mit dem angegebenen Namen und fügt dieses der DataColumnCollection hinzu.

Add(String, Type)

Erstellt ein DataColumn-Objekt mit dem angegebenen Namen und Typ und fügt dieses der DataColumnCollection hinzu.

Add(String, Type, String)

Erstellt ein DataColumn-Objekt mit dem angegebenen Namen, Typ und Ausdruck und fügt dieses der DataColumnCollection hinzu.

Add()

Erstellt ein DataColumn-Objekt und fügt dieses der DataColumnCollection hinzu.

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

Gibt zurück

Der neu erstellte DataColumn.

Beispiele

Im folgenden Beispiel wird eine neue DataColumn von DataColumnCollectionDataTableerstellt und hinzugefügt.

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.

Wenn die Auflistung durch Hinzufügen oder Entfernen von Spalten erfolgreich geändert wurde, tritt das CollectionChanged Ereignis auf.

Weitere Informationen

Gilt für:

Add(DataColumn)

Erstellt das angegebene DataColumn-Objekt und fügt dieses der DataColumnCollection hinzu.

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.

Ausnahmen

Der column-Parameter ist null.

Die Spalte gehört bereits zu dieser Auflistung, oder sie gehört zu einer anderen Auflistung.

Die Auflistung enthält bereits eine Spalte mit dem angegebenen Namen. (Beim Vergleich wird die Groß-/Kleinschreibung nicht berücksichtigt.)

Der Ausdruck ist ungültig. Weitere Informationen zum Erstellen von Ausdrücken finden Sie unter der Expression-Eigenschaft.

Beispiele

Im folgenden Beispiel wird einer DataColumnCollectionhinzugefügtDataColumn.

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 wurde, tritt das CollectionChanged Ereignis auf.

Weitere Informationen

Gilt für:

Add(String)

Erstellt ein DataColumn-Objekt mit dem angegebenen Namen und fügt dieses der DataColumnCollection hinzu.

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

Parameter

columnName
String

Der Name der Spalte.

Gibt zurück

Der neu erstellte DataColumn.

Ausnahmen

Die Auflistung enthält bereits eine Spalte mit dem angegebenen Namen. (Beim Vergleich wird die Groß-/Kleinschreibung nicht berücksichtigt.)

Beispiele

Im folgenden Beispiel wird ein neues DataColumn erstellt und zu einem DataColumnCollection von DataTablehinzugefügt.

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 stringdie für die DataType neue Spalte .

Wenn null oder eine leere Zeichenfolge ("") für den Namen übergeben wird, wird der Spalte ein Standardname ("Column1", "Column2" usw.) zugewiesen.

Verwenden Sie die Contains -Methode, um zu ermitteln, ob eine Spalte mit dem vorgeschlagenen Namen bereits in der Auflistung vorhanden ist.

Wenn die Auflistung durch Hinzufügen oder Entfernen von Spalten erfolgreich geändert wurde, tritt das CollectionChanged Ereignis auf.

Weitere Informationen

Gilt für:

Add(String, Type)

Erstellt ein DataColumn-Objekt mit dem angegebenen Namen und Typ und fügt dieses der DataColumnCollection hinzu.

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

Parameter

columnName
String

Der beim Erstellen der Spalte zu verwendende ColumnName.

type
Type

Der DataType der neuen Spalte.

Gibt zurück

Der neu erstellte DataColumn.

Ausnahmen

Die Auflistung enthält bereits eine Spalte mit dem angegebenen Namen. (Beim Vergleich wird die Groß-/Kleinschreibung nicht berücksichtigt.)

Der Ausdruck ist ungültig. Weitere Informationen zum Erstellen von Ausdrücken finden Sie unter der Expression-Eigenschaft.

Beispiele

Im folgenden Beispiel wird ein neues DataColumn erstellt und zu einem DataColumnCollection von DataTablehinzugefügt.

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 der Spalte ein Standardname ("Column1", "Column2" usw.) zugewiesen.

Verwenden Sie die Contains -Methode, um zu ermitteln, ob eine Spalte mit dem vorgeschlagenen Namen bereits in der Auflistung vorhanden ist.

Wenn die Auflistung durch Hinzufügen oder Entfernen von Spalten erfolgreich geändert wurde, tritt das CollectionChanged Ereignis auf.

Weitere Informationen

Gilt für:

Add(String, Type, String)

Erstellt ein DataColumn-Objekt mit dem angegebenen Namen, Typ und Ausdruck und fügt dieses der DataColumnCollection hinzu.

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

Parameter

columnName
String

Der beim Erstellen der Spalte zu verwendende Name.

type
Type

Der DataType der neuen Spalte.

expression
String

Der Ausdruck, der der Expression-Eigenschaft zugewiesen werden soll.

Gibt zurück

Der neu erstellte DataColumn.

Ausnahmen

Die Auflistung enthält bereits eine Spalte mit dem angegebenen Namen. (Beim Vergleich wird die Groß-/Kleinschreibung nicht berücksichtigt.)

Der Ausdruck ist ungültig. Weitere Informationen zum Erstellen von Ausdrücken finden Sie unter der Expression-Eigenschaft.

Beispiele

Im folgenden Beispiel wird ein neues DataColumn erstellt und zu einem DataColumnCollection von DataTablehinzugefügt.

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 der Spalte ein Standardname ("Column1", "Column2" usw.) zugewiesen.

Verwenden Sie die Contains -Methode, um zu ermitteln, ob eine Spalte mit dem vorgeschlagenen Namen bereits in der Auflistung vorhanden ist.

Wenn die Auflistung durch Hinzufügen oder Entfernen von Spalten erfolgreich geändert wurde, tritt das CollectionChanged Ereignis auf.

Weitere Informationen

Gilt für: