DataColumnCollection.Add Methode

Referenz

Definition

Namespace:: System.Data

Assembly:: System.Data.Common.dll

Assembly:: System.Data.dll

Assembly:: netstandard.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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()

Quelle:: DataColumnCollection.cs

Quelle:: DataColumnCollection.cs

Quelle:: DataColumnCollection.cs

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

DataColumn

Der neu erstellte DataColumn.

Beispiele

Im folgenden Beispiel wird ein neues DataColumn erstellt und hinzugefügt 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

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)

Quelle:: DataColumnCollection.cs

Quelle:: DataColumnCollection.cs

Quelle:: DataColumnCollection.cs

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

ArgumentNullException

Der column-Parameter ist null.

ArgumentException

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

DuplicateNameException

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

InvalidExpressionException

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

Beispiele

Im folgenden Beispiel wird einer DataColumn DataColumnCollectionhinzugefügt.

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)

Quelle:: DataColumnCollection.cs

Quelle:: DataColumnCollection.cs

Quelle:: DataColumnCollection.cs

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

DataColumn

Der neu erstellte DataColumn.

Ausnahmen

DuplicateNameException

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 hinzugefügt 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 .

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 bestimmen, 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)

Quelle:: DataColumnCollection.cs

Quelle:: DataColumnCollection.cs

Quelle:: DataColumnCollection.cs

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

DataColumn

Der neu erstellte DataColumn.

Ausnahmen

DuplicateNameException

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

InvalidExpressionException

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

Verwenden Sie die Contains -Methode, um zu bestimmen, 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)

Quelle:: DataColumnCollection.cs

Quelle:: DataColumnCollection.cs

Quelle:: DataColumnCollection.cs

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

DataColumn

Der neu erstellte DataColumn.

Ausnahmen

DuplicateNameException

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

InvalidExpressionException

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

Verwenden Sie die Contains -Methode, um zu bestimmen, 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:

Freigeben über

DataColumnCollection.Add Methode

Definition

Überlädt

Add()

Gibt zurück

Beispiele

Hinweise

Weitere Informationen

Gilt für:

Add(DataColumn)

Parameter

Ausnahmen

Beispiele

Hinweise

Weitere Informationen

Gilt für:

Add(String)

Parameter

Gibt zurück

Ausnahmen

Beispiele

Hinweise

Weitere Informationen

Gilt für:

Add(String, Type)

Parameter

Gibt zurück

Ausnahmen

Beispiele

Hinweise

Weitere Informationen

Gilt für:

Add(String, Type, String)

Parameter

Gibt zurück

Ausnahmen

Beispiele

Hinweise

Weitere Informationen

Gilt für:

Zusätzliche Ressourcen