Udostępnij za pośrednictwem


DataColumnCollection.Add Metoda

Definicja

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
Źródło:
DataColumnCollection.cs
Źródło:
DataColumnCollection.cs

Tworzy i dodaje DataColumn obiekt do obiektu 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

Zwraca

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ż

Dotyczy

Add(DataColumn)

Źródło:
DataColumnCollection.cs
Źródło:
DataColumnCollection.cs
Ź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

Parametr column to null.

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

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

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ż

Dotyczy

Add(String)

Źródło:
DataColumnCollection.cs
Źródło:
DataColumnCollection.cs
Ź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:
 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

Parametry

columnName
String

Nazwa kolumny.

Zwraca

Nowo utworzony element DataColumn.

Wyjątki

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ż

Dotyczy

Add(String, Type)

Źródło:
DataColumnCollection.cs
Źródło:
DataColumnCollection.cs
Ź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:
 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

Parametry

columnName
String

Element ColumnName do użycia podczas tworzenia kolumny.

type
Type

Nowa kolumna DataType .

Zwraca

Nowo utworzony element DataColumn.

Wyjątki

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

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ż

Dotyczy

Add(String, Type, String)

Źródło:
DataColumnCollection.cs
Źródło:
DataColumnCollection.cs
Ź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:
 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

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

Nowo utworzony element DataColumn.

Wyjątki

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

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ż

Dotyczy