DataColumnCollection.Add Methode

Definition

Namespace:: System.Data

Assemblys:: netstandard.dll, System.Data.Common.dll

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 und fügt ein DataColumn Objekt zum DataColumnCollection.

Überlädt

Name	Beschreibung
Add()	Erstellt und fügt ein DataColumn Objekt zum DataColumnCollection.
Add(DataColumn)	Erstellt und fügt das angegebene DataColumn Objekt dem DataColumnCollection.
Add(String)	Erstellt ein Objekt mit dem angegebenen Namen und fügt es DataColumn hinzu DataColumnCollection.
Add(String, Type)	Erstellt und fügt ein DataColumn Objekt hinzu, das den angegebenen Namen und typ aufweist.DataColumnCollection
Add(String, Type, String)	Erstellt und fügt ein DataColumn Objekt mit dem angegebenen Namen, Typ und Ausdruck zum DataColumnCollection.

Add()

Quelle:: DataColumnCollection.cs

Quelle:: DataColumnCollection.cs

Quelle:: DataColumnCollection.cs

Quelle:: DataColumnCollection.cs

Quelle:: DataColumnCollection.cs

Erstellt und fügt ein DataColumn Objekt zum 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

Gibt zurück

DataColumn

Die neu erstellte DataColumn.

Beispiele

Im folgenden Beispiel wird ein neues DataColumn Objekt 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 ("Spalte1", "Spalte2" usw.) zugewiesen.

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

Weitere Informationen

Gilt für:

Add(DataColumn)

Quelle:: DataColumnCollection.cs

Quelle:: DataColumnCollection.cs

Quelle:: DataColumnCollection.cs

Quelle:: DataColumnCollection.cs

Quelle:: DataColumnCollection.cs

Erstellt und fügt das angegebene DataColumn Objekt dem 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

Der DataColumn hinzuzufügende

Ausnahmen

ArgumentNullException

Der column Parameter ist null.

ArgumentException

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

DuplicateNameException

Die Auflistung verfügt bereits über eine Spalte mit dem angegebenen Namen. (Bei dem Vergleich wird die Groß-/Kleinschreibung nicht beachtet.)

InvalidExpressionException

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

Beispiele

Im folgenden Beispiel wird einer DataColumn .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 erfolgreich durch Hinzufügen oder Entfernen von Spalten geändert wird, tritt das CollectionChanged Ereignis auf.

Weitere Informationen

Gilt für:

Add(String)

Quelle:: DataColumnCollection.cs

Quelle:: DataColumnCollection.cs

Quelle:: DataColumnCollection.cs

Quelle:: DataColumnCollection.cs

Quelle:: DataColumnCollection.cs

Erstellt ein Objekt mit dem angegebenen Namen und fügt es DataColumn hinzu 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

Parameter

columnName: String

Der Name der Spalte.

Gibt zurück

DataColumn

Die neu erstellte DataColumn.

Ausnahmen

DuplicateNameException

Die Auflistung verfügt bereits über eine Spalte mit dem angegebenen Namen. (Bei dem Vergleich wird die Groß-/Kleinschreibung nicht beachtet.)

Beispiele

Im folgenden Beispiel wird ein DataColumn neues DataColumnCollection Objekt DataTableerstellt 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("Total")

    With column
       .DataType = System.Type.GetType("System.Decimal")
       .ReadOnly = True
       .Expression = "UnitPrice * Quantity"
       .Unique = False
    End With
End Sub

Hinweise

Standardmäßig lautet DataTypedie string neue Spalte .

Wenn null eine leere Zeichenfolge ("") für den Namen übergeben wird, wird der Spalte ein Standardname ("Spalte1", "Spalte2" usw.) übergeben.

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

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

Weitere Informationen

Gilt für:

Add(String, Type)

Quelle:: DataColumnCollection.cs

Quelle:: DataColumnCollection.cs

Quelle:: DataColumnCollection.cs

Quelle:: DataColumnCollection.cs

Quelle:: DataColumnCollection.cs

Erstellt und fügt ein DataColumn Objekt hinzu, das den angegebenen Namen und typ aufweist.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

Parameter

columnName: String

Die ColumnName zu verwendende Verwendung beim Erstellen der Spalte.

type: Type

Die DataType der neuen Spalte.

Gibt zurück

DataColumn

Die neu erstellte DataColumn.

Ausnahmen

DuplicateNameException

Die Auflistung verfügt bereits über eine Spalte mit dem angegebenen Namen. (Bei dem Vergleich wird die Groß-/Kleinschreibung nicht beachtet.)

InvalidExpressionException

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

Beispiele

Im folgenden Beispiel wird ein DataColumn neues DataColumnCollection Objekt DataTableerstellt und hinzugefü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 eine leere Zeichenfolge ("") für den Namen übergeben wird, wird der Spalte ein Standardname ("Spalte1", "Spalte2" usw.) übergeben.

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

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

Weitere Informationen

Gilt für:

Add(String, Type, String)

Quelle:: DataColumnCollection.cs

Quelle:: DataColumnCollection.cs

Quelle:: DataColumnCollection.cs

Quelle:: DataColumnCollection.cs

Quelle:: DataColumnCollection.cs

Erstellt und fügt ein DataColumn Objekt mit dem angegebenen Namen, Typ und Ausdruck zum 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);

[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Members might be trimmed for some data types or expressions.")]
public System.Data.DataColumn Add(string? columnName, Type type, 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);

[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Members might be trimmed for some data types or expressions.")>]
member this.Add : string * Type * string -> System.Data.DataColumn

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 Name, der beim Erstellen der Spalte verwendet werden soll.

type: Type

Die DataType der neuen Spalte.

expression: String

Der Ausdruck, der der Expression Eigenschaft zugewiesen werden soll.

Gibt zurück

DataColumn

Die neu erstellte DataColumn.

Attribute: RequiresUnreferencedCodeAttribute

Ausnahmen

DuplicateNameException

Die Auflistung verfügt bereits über eine Spalte mit dem angegebenen Namen. (Bei dem Vergleich wird die Groß-/Kleinschreibung nicht beachtet.)

InvalidExpressionException

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

Beispiele

Im folgenden Beispiel wird ein DataColumn neues DataColumnCollection Objekt DataTableerstellt und hinzugefü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 eine leere Zeichenfolge ("") für den Namen übergeben wird, wird der Spalte ein Standardname ("Spalte1", "Spalte2" usw.) übergeben.

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

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

Weitere Informationen

Gilt für:

Feedback

War diese Seite hilfreich?