DataColumnCollection.Add Metoda

Odwołanie

Definicja

Przestrzeń nazw:: System.Data

Zestaw:: System.Data.Common.dll

Zestaw:: System.Data.dll

Zestaw:: netstandard.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

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

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

DataColumn

Nowo utworzony element DataColumn.

Przykłady

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

Domyślna nazwa ("Kolumna1", "Kolumna2" itd.) jest podawana kolumnie.

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

Zobacz też

Dotyczy

Add(DataColumn)

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 ma wartość null.

ArgumentException

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

DuplicateNameException

Kolekcja ma już kolumnę o określonej nazwie. (W porównaniu nie jest uwzględniana wielkość liter).

InvalidExpressionException

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

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 wystąpi zdarzenie.

Zobacz też

Dotyczy

Add(String)

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

DataColumn

Nowo utworzony element DataColumn.

Wyjątki

DuplicateNameException

Kolekcja ma już kolumnę o określonej nazwie. (W porównaniu nie jest uwzględniana wielkość liter).

Przykłady

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

Uwagi

Domyślnie wartość DataType dla nowej kolumny to string.

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

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 wystąpi zdarzenie.

Zobacz też

Dotyczy

Add(String, Type)

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

Wartość DataType nowej kolumny.

Zwraca

DataColumn

Nowo utworzony element DataColumn.

Wyjątki

DuplicateNameException

Kolekcja ma już kolumnę o określonej nazwie. (W porównaniu nie jest uwzględniana wielkość liter).

InvalidExpressionException

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

Przykłady

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

Uwagi

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

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 wystąpi zdarzenie.

Zobacz też

Dotyczy

Add(String, Type, String)

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

Wartość DataType nowej kolumny.

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. (W porównaniu nie jest uwzględniana wielkość liter).

InvalidExpressionException

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

Przykłady

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

Uwagi

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

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 wystąpi zdarzenie.

Zobacz też

Dotyczy