DataColumnCollection.Add Methode

Definitie

Naamruimte:: System.Data

Assembly:: System.Data.dll

Assembly:: netstandard.dll

Belangrijk

Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.

Hiermee maakt en voegt u een DataColumn object toe aan de DataColumnCollection.

Overloads

Name	Description
Add()	Hiermee maakt en voegt u een DataColumn object toe aan de DataColumnCollection.
Add(DataColumn)	Hiermee maakt en voegt u het opgegeven DataColumn object toe aan de DataColumnCollection.
Add(String)	Hiermee maakt en voegt u een DataColumn object toe met de opgegeven naam aan de DataColumnCollection.
Add(String, Type)	Hiermee maakt u een DataColumn object met de opgegeven naam en typt DataColumnCollectionu het object.
Add(String, Type, String)	Hiermee maakt u een DataColumn object met de opgegeven naam, het type en de expressie aan de DataColumnCollection.

Add()

Hiermee maakt en voegt u een DataColumn object toe aan de DataColumnCollection.

public:
 virtual System::Data::DataColumn ^ Add();

public:
 System::Data::DataColumn ^ Add();

public virtual System.Data.DataColumn Add();

public System.Data.DataColumn Add();

abstract member Add : unit -> System.Data.DataColumn
override this.Add : unit -> System.Data.DataColumn

member this.Add : unit -> System.Data.DataColumn

Public Overridable Function Add () As DataColumn

Public Function Add () As DataColumn

Retouren

DataColumn

De zojuist gemaakte DataColumn.

Voorbeelden

In het volgende voorbeeld wordt een nieuw DataColumn bestand gemaakt en toegevoegd aan een 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

Opmerkingen

Er wordt een standaardnaam ('Kolom1', 'Kolom2' enzovoort) aan de kolom gegeven.

Als de verzameling is gewijzigd door kolommen toe te voegen of te verwijderen, vindt de CollectionChanged gebeurtenis plaats.

Zie ook

Van toepassing op

Add(DataColumn)

Hiermee maakt en voegt u het opgegeven DataColumn object toe aan de 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)

Parameters

column: DataColumn

De DataColumn te toevoegen.

Uitzonderingen

ArgumentNullException

De column parameter is null.

ArgumentException

De kolom behoort al tot deze verzameling of tot een andere verzameling.

DuplicateNameException

De verzameling heeft al een kolom met de opgegeven naam. (De vergelijking is niet hoofdlettergevoelig.)

InvalidExpressionException

De expressie is ongeldig. Zie de Expression eigenschap voor meer informatie over het maken van expressies.

Voorbeelden

In het volgende voorbeeld wordt een DataColumn aan een 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

Opmerkingen

Als de verzameling is gewijzigd door kolommen toe te voegen of te verwijderen, vindt de CollectionChanged gebeurtenis plaats.

Zie ook

Van toepassing op

Add(String)

Hiermee maakt en voegt u een DataColumn object toe met de opgegeven naam aan de DataColumnCollection.

public:
 virtual System::Data::DataColumn ^ Add(System::String ^ columnName);

public:
 System::Data::DataColumn ^ Add(System::String ^ columnName);

public virtual System.Data.DataColumn Add(string columnName);

public System.Data.DataColumn Add(string columnName);

abstract member Add : string -> System.Data.DataColumn
override this.Add : string -> System.Data.DataColumn

member this.Add : string -> System.Data.DataColumn

Public Overridable Function Add (columnName As String) As DataColumn

Public Function Add (columnName As String) As DataColumn

Parameters

columnName: String

De naam van de kolom.

Retouren

DataColumn

De zojuist gemaakte DataColumn.

Uitzonderingen

DuplicateNameException

De verzameling heeft al een kolom met de opgegeven naam. (De vergelijking is niet hoofdlettergevoelig.)

Voorbeelden

In het volgende voorbeeld wordt een nieuw DataColumn item gemaakt en toegevoegd aan een van een 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

Opmerkingen

DataType De standaardwaarde voor de nieuwe kolom is string.

Als null of een lege tekenreeks ("") wordt doorgegeven voor de naam, wordt een standaardnaam ('Kolom1', 'Kolom2' enzovoort) aan de kolom gegeven.

Gebruik de Contains methode om te bepalen of er al een kolom met de voorgestelde naam in de verzameling bestaat.

Als de verzameling is gewijzigd door kolommen toe te voegen of te verwijderen, vindt de CollectionChanged gebeurtenis plaats.

Zie ook

Van toepassing op

Add(String, Type)

Hiermee maakt u een DataColumn object met de opgegeven naam en typt DataColumnCollectionu het object.

public:
 virtual System::Data::DataColumn ^ Add(System::String ^ columnName, Type ^ type);

public:
 System::Data::DataColumn ^ Add(System::String ^ columnName, Type ^ type);

public virtual System.Data.DataColumn Add(string columnName, Type type);

public System.Data.DataColumn Add(string columnName, Type type);

abstract member Add : string * Type -> System.Data.DataColumn
override this.Add : string * Type -> System.Data.DataColumn

member this.Add : string * Type -> System.Data.DataColumn

Public Overridable Function Add (columnName As String, type As Type) As DataColumn

Public Function Add (columnName As String, type As Type) As DataColumn

Parameters

columnName: String

De ColumnName te gebruiken functie bij het maken van de kolom.

type: Type

De DataType nieuwe kolom.

Retouren

DataColumn

De zojuist gemaakte DataColumn.

Uitzonderingen

DuplicateNameException

De verzameling heeft al een kolom met de opgegeven naam. (De vergelijking is niet hoofdlettergevoelig.)

InvalidExpressionException

De expressie is ongeldig. Zie de Expression eigenschap voor meer informatie over het maken van expressies.

Voorbeelden

In het volgende voorbeeld wordt een nieuw DataColumn item gemaakt en toegevoegd aan een van een 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

Opmerkingen

Als null of een lege tekenreeks ("") wordt doorgegeven voor de naam, wordt een standaardnaam ('Kolom1', 'Kolom2' enzovoort) aan de kolom gegeven.

Gebruik de Contains methode om te bepalen of er al een kolom met de voorgestelde naam in de verzameling bestaat.

Als de verzameling is gewijzigd door kolommen toe te voegen of te verwijderen, vindt de CollectionChanged gebeurtenis plaats.

Zie ook

Van toepassing op

Add(String, Type, String)

Hiermee maakt u een DataColumn object met de opgegeven naam, het type en de expressie aan de DataColumnCollection.

public:
 virtual System::Data::DataColumn ^ Add(System::String ^ columnName, Type ^ type, System::String ^ expression);

public:
 System::Data::DataColumn ^ Add(System::String ^ columnName, Type ^ type, System::String ^ expression);

public virtual System.Data.DataColumn Add(string columnName, Type type, string expression);

public 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

member this.Add : string * Type * string -> System.Data.DataColumn

Public Overridable Function Add (columnName As String, type As Type, expression As String) As DataColumn

Public Function Add (columnName As String, type As Type, expression As String) As DataColumn

Parameters

columnName: String

De naam die u moet gebruiken bij het maken van de kolom.

type: Type

De DataType nieuwe kolom.

expression: String

De expressie die moet worden toegewezen aan de Expression eigenschap.

Retouren

DataColumn

De zojuist gemaakte DataColumn.

Uitzonderingen

DuplicateNameException

De verzameling heeft al een kolom met de opgegeven naam. (De vergelijking is niet hoofdlettergevoelig.)

InvalidExpressionException

De expressie is ongeldig. Zie de Expression eigenschap voor meer informatie over het maken van expressies.

Voorbeelden

In het volgende voorbeeld wordt een nieuw DataColumn item gemaakt en toegevoegd aan een van een 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

Opmerkingen

Als null of een lege tekenreeks ("") wordt doorgegeven voor de naam, wordt een standaardnaam ('Kolom1', 'Kolom2' enzovoort) aan de kolom gegeven.

Gebruik de Contains methode om te bepalen of er al een kolom met de voorgestelde naam in de verzameling bestaat.

Als de verzameling is gewijzigd door kolommen toe te voegen of te verwijderen, vindt de CollectionChanged gebeurtenis plaats.

Zie ook

Van toepassing op

Feedback

Is deze pagina nuttig?