DataColumnCollection.Add Метод

Определение

Создает и добавляет объект DataColumn в DataColumnCollection.Creates and adds a DataColumn object to the DataColumnCollection.

Перегрузки

Add()

Создает и добавляет объект DataColumn в DataColumnCollection.Creates and adds a DataColumn object to the DataColumnCollection.

Add(DataColumn)

Создает и добавляет указанный объект DataColumn в DataColumnCollection.Creates and adds the specified DataColumn object to the DataColumnCollection.

Add(String)

Создает и добавляет объект DataColumn с указанным именем к DataColumnCollection.Creates and adds a DataColumn object that has the specified name to the DataColumnCollection.

Add(String, Type)

Создает и добавляет объект DataColumn с указанным именем и типом в DataColumnCollection.Creates and adds a DataColumn object that has the specified name and type to the DataColumnCollection.

Add(String, Type, String)

Создает и добавляет объект DataColumn с указанным именем, типом и выражением в DataColumnCollection.Creates and adds a DataColumn object that has the specified name, type, and expression to the DataColumnCollection.

Add()

Создает и добавляет объект DataColumn в DataColumnCollection.Creates and adds a DataColumn object to the 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

Возвращаемое значение

DataColumn

Вновь созданный DataColumn.The newly created DataColumn.

Примеры

В следующем примере создается и добавляется новый объект DataColumn в объект DataColumnCollection DataTable .The following example creates and adds a new DataColumn to the DataColumnCollection of a 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

Комментарии

Столбцу присваивается имя по умолчанию («Столбец1», «Столбец2» и т. д.).A default name ("Column1", "Column2", and so on) is given to the column.

Если коллекция успешно изменялась путем добавления или удаления столбцов, CollectionChanged возникает событие.If the collection is successfully changed by adding or removing columns, the CollectionChanged event occurs.

См. также раздел

Применяется к

Add(DataColumn)

Создает и добавляет указанный объект DataColumn в DataColumnCollection.Creates and adds the specified DataColumn object to the 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)

Параметры

column
DataColumn

Добавляемый объект DataColumn.The DataColumn to add.

Исключения

Параметр column имеет значение null.The column parameter is null.

Столбец уже принадлежит данной или другой коллекции.The column already belongs to this collection, or to another collection.

Коллекция уже содержит столбец с указанным именем.The collection already has a column with the specified name. (Сравнение выполняется без учета регистра.)(The comparison is not case-sensitive.)

Недопустимое выражение.The expression is invalid. Дополнительные сведения о создании выражений см. в описании свойства Expression.See the Expression property for more information about how to create expressions.

Примеры

В следующем примере добавляется DataColumn в DataColumnCollection .The following example adds a DataColumn to a 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

Комментарии

Если коллекция успешно изменялась путем добавления или удаления столбцов, CollectionChanged возникает событие.If the collection is successfully changed by adding or removing columns, the CollectionChanged event occurs.

См. также раздел

Применяется к

Add(String)

Создает и добавляет объект DataColumn с указанным именем к DataColumnCollection.Creates and adds a DataColumn object that has the specified name to the 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

Параметры

columnName
String

Имя столбца.The name of the column.

Возвращаемое значение

DataColumn

Вновь созданный DataColumn.The newly created DataColumn.

Исключения

Коллекция уже содержит столбец с указанным именем.The collection already has a column with the specified name. (Сравнение выполняется без учета регистра.)(The comparison is not case-sensitive.)

Примеры

В следующем примере создается и добавляется новый объект DataColumn в объект DataColumnCollection DataTable .The following example creates and adds a new DataColumn to a DataColumnCollection of a 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

Комментарии

По умолчанию DataType для нового столбца используется значение string .By default, the DataType for the new column is string.

Если null в качестве имени передается пустая строка (""), то столбцу присваивается имя по умолчанию ("Column1", "Столбец2" и т. д.).If null or an empty string ("") is passed in for the name, a default name ("Column1", "Column2", and so on) is given to the column.

Используйте Contains метод, чтобы определить, существует ли в коллекции столбец с предложенным именем.Use the Contains method to determine whether a column with the proposed name already exists in the collection.

Если коллекция успешно изменялась путем добавления или удаления столбцов, CollectionChanged возникает событие.If the collection is successfully changed by adding or removing columns, the CollectionChanged event occurs.

См. также раздел

Применяется к

Add(String, Type)

Создает и добавляет объект DataColumn с указанным именем и типом в DataColumnCollection.Creates and adds a DataColumn object that has the specified name and type to the 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

Параметры

columnName
String

Свойство ColumnName, используемое при создании столбца.The ColumnName to use when you create the column.

type
Type

Свойство DataType нового столбца.The DataType of the new column.

Возвращаемое значение

DataColumn

Вновь созданный DataColumn.The newly created DataColumn.

Исключения

Коллекция уже содержит столбец с указанным именем.The collection already has a column with the specified name. (Сравнение выполняется без учета регистра.)(The comparison is not case-sensitive.)

Недопустимое выражение.The expression is invalid. Дополнительные сведения о создании выражений см. в описании свойства Expression.See the Expression property for more information about how to create expressions.

Примеры

В следующем примере создается и добавляется новый объект DataColumn в объект DataColumnCollection DataTable .The following example creates and adds a new DataColumn to a DataColumnCollection of a 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

Комментарии

Если null в качестве имени передается пустая строка (""), то столбцу присваивается имя по умолчанию ("Column1", "Столбец2" и т. д.).If null or an empty string ("") is passed in for the name, a default name ("Column1", "Column2", and so on) is given to the column.

Используйте Contains метод, чтобы определить, существует ли в коллекции столбец с предложенным именем.Use the Contains method to determine whether a column with the proposed name already exists in the collection.

Если коллекция успешно изменялась путем добавления или удаления столбцов, CollectionChanged возникает событие.If the collection is successfully changed by adding or removing columns, the CollectionChanged event occurs.

См. также раздел

Применяется к

Add(String, Type, String)

Создает и добавляет объект DataColumn с указанным именем, типом и выражением в DataColumnCollection.Creates and adds a DataColumn object that has the specified name, type, and expression to the 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

Параметры

columnName
String

Имя, используемое при создании столбца.The name to use when you create the column.

type
Type

Свойство DataType нового столбца.The DataType of the new column.

expression
String

Выражение, назначаемое свойству Expression.The expression to assign to the Expression property.

Возвращаемое значение

DataColumn

Вновь созданный DataColumn.The newly created DataColumn.

Исключения

Коллекция уже содержит столбец с указанным именем.The collection already has a column with the specified name. (Сравнение выполняется без учета регистра.)(The comparison is not case-sensitive.)

Недопустимое выражение.The expression is invalid. Дополнительные сведения о создании выражений см. в описании свойства Expression.See the Expression property for more information about how to create expressions.

Примеры

В следующем примере создается и добавляется новый объект DataColumn в объект DataColumnCollection DataTable .The following example creates and adds a new DataColumn to a DataColumnCollection of a 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

Комментарии

Если null в качестве имени передается пустая строка (""), то столбцу присваивается имя по умолчанию ("Column1", "Столбец2" и т. д.).If null or an empty string ("") is passed in for the name, a default name ("Column1", "Column2", and so on) is given to the column.

Используйте Contains метод, чтобы определить, существует ли в коллекции столбец с предложенным именем.Use the Contains method to determine whether a column with the proposed name already exists in the collection.

Если коллекция успешно изменялась путем добавления или удаления столбцов, CollectionChanged возникает событие.If the collection is successfully changed by adding or removing columns, the CollectionChanged event occurs.

См. также раздел

Применяется к