DataColumnCollection.Add Metoda

Definicja

Przestrzeń nazw:

System.Data

Zestaw:

System.Data.Common.dll

Tworzy i dodaje DataColumn obiekt do obiektu DataColumnCollection.

Przeciążenia

Add()	Tworzy i dodaje DataColumn obiekt do obiektu DataColumnCollection.
Add(DataColumn)	Tworzy i dodaje określony DataColumn obiekt do obiektu DataColumnCollection.
Add(String)	Tworzy i dodaje DataColumn obiekt o określonej nazwie do obiektu DataColumnCollection.
Add(String, Type)	Tworzy i dodaje DataColumn obiekt o określonej nazwie i typie do obiektu DataColumnCollection.
Add(String, Type, String)	Tworzy i dodaje DataColumn obiekt o określonej nazwie, typie i wyrażeniu do obiektu DataColumnCollection.

Add()

Źródło:

DataColumnCollection.cs

Tworzy i dodaje DataColumn obiekt do obiektu DataColumnCollection.

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

public System.Data.DataColumn Add ();

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

Public Function Add () As DataColumn

Zwraca

DataColumn

Nowo utworzony element DataColumn.

Przykłady

Poniższy przykład tworzy i dodaje nowy DataColumn element do DataColumnCollection elementu 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

Uwagi

Do kolumny jest podawana nazwa domyślna ("Column1", "Column2 itd.).

Jeśli kolekcja zostanie pomyślnie zmieniona przez dodanie lub usunięcie kolumn, CollectionChanged zdarzenie zostanie wykonane.

Zobacz też

• ColumnName
• Contains(String)
• DataType
• Expression

Add(DataColumn)

Źródło:

DataColumnCollection.cs

Tworzy i dodaje określony DataColumn obiekt do obiektu 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)

Parametry

column

DataColumn

Element do dodania DataColumn .

Wyjątki

ArgumentNullException

Parametr column to null.

ArgumentException

Kolumna należy już do tej kolekcji lub do innej kolekcji.

DuplicateNameException

Kolekcja ma już kolumnę o określonej nazwie. (Porównanie nie uwzględnia wielkości liter).

InvalidExpressionException

Wyrażenie jest nieprawidłowe. Expression Aby uzyskać więcej informacji na temat tworzenia wyrażeń, zobacz właściwość .

Przykłady

Poniższy przykład dodaje element DataColumn do elementu 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

Uwagi

Jeśli kolekcja zostanie pomyślnie zmieniona przez dodanie lub usunięcie kolumn, CollectionChanged zdarzenie zostanie wykonane.

Zobacz też

• ColumnName
• CollectionChanged
• Contains(String)
• DataType
• Expression

Add(String)

Źródło:

DataColumnCollection.cs

Tworzy i dodaje DataColumn obiekt o określonej nazwie do obiektu DataColumnCollection.

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

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

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

Public Function Add (columnName As String) As DataColumn

Parametry

columnName

String

Nazwa kolumny.

Zwraca

DataColumn

Nowo utworzony element DataColumn.

Wyjątki

DuplicateNameException

Kolekcja ma już kolumnę o określonej nazwie. (Porównanie nie uwzględnia wielkości liter).

Przykłady

Poniższy przykład tworzy i dodaje nowy DataColumn element do DataColumnCollection elementu 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

Uwagi

Domyślnie dla DataType nowej kolumny to string.

Jeśli null lub pusty ciąg ("") jest przekazywany dla nazwy, domyślna nazwa ("Column1", "Column2", itd.) jest podawana do kolumny.

Contains Użyj metody , aby określić, czy kolumna o proponowanej nazwie już istnieje w kolekcji.

Jeśli kolekcja zostanie pomyślnie zmieniona przez dodanie lub usunięcie kolumn, CollectionChanged zdarzenie zostanie wykonane.

Zobacz też

• ColumnName
• Contains(String)
• DataType
• Expression

Add(String, Type)

Źródło:

DataColumnCollection.cs

Tworzy i dodaje DataColumn obiekt o określonej nazwie i typie do obiektu DataColumnCollection.

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

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

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

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

Parametry

columnName

String

Element ColumnName do użycia podczas tworzenia kolumny.

type

Type

Nowa kolumna DataType .

Zwraca

DataColumn

Nowo utworzony element DataColumn.

Wyjątki

DuplicateNameException

Kolekcja ma już kolumnę o określonej nazwie. (Porównanie nie uwzględnia wielkości liter).

InvalidExpressionException

Wyrażenie jest nieprawidłowe. Expression Aby uzyskać więcej informacji na temat tworzenia wyrażeń, zobacz właściwość .

Przykłady

Poniższy przykład tworzy i dodaje nowy DataColumn element do DataColumnCollection elementu 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

Uwagi

Jeśli null lub pusty ciąg ("") jest przekazywany dla nazwy, domyślna nazwa ("Column1", "Column2", itd.) jest podawana do kolumny.

Contains Użyj metody , aby określić, czy kolumna o proponowanej nazwie już istnieje w kolekcji.

Jeśli kolekcja zostanie pomyślnie zmieniona przez dodanie lub usunięcie kolumn, CollectionChanged zdarzenie zostanie wykonane.

Zobacz też

• ColumnName
• DataType
• Expression

Add(String, Type, String)

Źródło:

DataColumnCollection.cs

Tworzy i dodaje DataColumn obiekt o określonej nazwie, typie i wyrażeniu do obiektu DataColumnCollection.

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

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

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

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

Parametry

columnName

String

Nazwa do użycia podczas tworzenia kolumny.

type

Type

Nowa kolumna DataType .

expression

String

Wyrażenie do przypisania do Expression właściwości.

Zwraca

DataColumn

Nowo utworzony element DataColumn.

Wyjątki

DuplicateNameException

Kolekcja ma już kolumnę o określonej nazwie. (Porównanie nie uwzględnia wielkości liter).

InvalidExpressionException

Wyrażenie jest nieprawidłowe. Expression Aby uzyskać więcej informacji na temat tworzenia wyrażeń, zobacz właściwość .

Przykłady

Poniższy przykład tworzy i dodaje nowy DataColumn element do DataColumnCollection elementu 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

Uwagi

Jeśli null lub pusty ciąg ("") jest przekazywany dla nazwy, domyślna nazwa ("Column1", "Column2", itd.) jest podawana do kolumny.

Contains Użyj metody , aby określić, czy kolumna o proponowanej nazwie już istnieje w kolekcji.

Jeśli kolekcja zostanie pomyślnie zmieniona przez dodanie lub usunięcie kolumn, CollectionChanged zdarzenie zostanie wykonane.

Zobacz też

• ColumnName
• Contains(String)
• DataType
• Expression