DataColumnCollection.Add Метод

Определение

Пространство имен:

System.Data

Сборка:

System.Data.Common.dll

Создает и добавляет объект DataColumn в DataColumnCollection.

Перегрузки

Add()	Создает и добавляет объект DataColumn в DataColumnCollection.
Add(DataColumn)	Создает и добавляет указанный объект DataColumn в DataColumnCollection.
Add(String)	Создает и добавляет объект DataColumn с указанным именем к DataColumnCollection.
Add(String, Type)	Создает и добавляет объект DataColumn с указанным именем и типом в DataColumnCollection.
Add(String, Type, String)	Создает и добавляет объект DataColumn с указанным именем, типом и выражением в DataColumnCollection.

Add()

Исходный код:

DataColumnCollection.cs

Создает и добавляет объект DataColumn в DataColumnCollection.

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

public System.Data.DataColumn Add ();

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

Public Function Add () As DataColumn

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

DataColumn

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

Примеры

В следующем примере создается и добавляется новый DataColumn объект в объект 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

Комментарии

Столбцу присваивается имя по умолчанию ("Столбец1", "Столбец2" и т. д.).

Если коллекция успешно изменена путем добавления или удаления столбцов, CollectionChanged происходит событие .

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

• ColumnName
• Contains(String)
• DataType
• Expression

Add(DataColumn)

Исходный код:

DataColumnCollection.cs

Создает и добавляет указанный объект DataColumn в 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.

Исключения

ArgumentNullException

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

ArgumentException

Столбец уже принадлежит данной или другой коллекции.

DuplicateNameException

Коллекция уже содержит столбец с указанным именем. (Сравнение выполняется без учета регистра.)

InvalidExpressionException

Недопустимое выражение. Дополнительные сведения о создании выражений см. в описании свойства Expression.

Примеры

В следующем примере добавляется в DataColumnDataColumnCollection.

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 происходит событие .

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

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

Add(String)

Исходный код:

DataColumnCollection.cs

Создает и добавляет объект DataColumn с указанным именем к 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

Параметры

columnName

String

Имя столбца.

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

DataColumn

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

Исключения

DuplicateNameException

Коллекция уже содержит столбец с указанным именем. (Сравнение выполняется без учета регистра.)

Примеры

В следующем примере создается и добавляется новый DataColumn объект объекта DataColumnCollectionDataTable.

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.

Если null для имени передается пустая строка (""), то столбцу присваивается имя по умолчанию ("Столбец1", "Столбец2" и т. д.).

Используйте метод , Contains чтобы определить, существует ли столбец с предложенным именем в коллекции.

Если коллекция успешно изменена путем добавления или удаления столбцов, CollectionChanged происходит событие .

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

• ColumnName
• Contains(String)
• DataType
• Expression

Add(String, Type)

Исходный код:

DataColumnCollection.cs

Создает и добавляет объект DataColumn с указанным именем и типом в 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

Параметры

columnName

String

Свойство ColumnName, используемое при создании столбца.

type

Type

Свойство DataType нового столбца.

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

DataColumn

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

Исключения

DuplicateNameException

Коллекция уже содержит столбец с указанным именем. (Сравнение выполняется без учета регистра.)

InvalidExpressionException

Недопустимое выражение. Дополнительные сведения о создании выражений см. в описании свойства Expression.

Примеры

В следующем примере создается и добавляется новый DataColumn объект объекта DataColumnCollectionDataTable.

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 для имени передается пустая строка (""), то столбцу присваивается имя по умолчанию ("Столбец1", "Столбец2" и т. д.).

Используйте метод , Contains чтобы определить, существует ли столбец с предложенным именем в коллекции.

Если коллекция успешно изменена путем добавления или удаления столбцов, CollectionChanged происходит событие .

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

• ColumnName
• DataType
• Expression

Add(String, Type, String)

Исходный код:

DataColumnCollection.cs

Создает и добавляет объект DataColumn с указанным именем, типом и выражением в 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

Параметры

columnName

String

Имя, используемое при создании столбца.

type

Type

Свойство DataType нового столбца.

expression

String

Выражение, назначаемое свойству Expression.

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

DataColumn

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

Исключения

DuplicateNameException

Коллекция уже содержит столбец с указанным именем. (Сравнение выполняется без учета регистра.)

InvalidExpressionException

Недопустимое выражение. Дополнительные сведения о создании выражений см. в описании свойства Expression.

Примеры

В следующем примере создается и добавляется новый DataColumn объект объекта DataColumnCollectionDataTable.

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 для имени передается пустая строка (""), то столбцу присваивается имя по умолчанию ("Столбец1", "Столбец2" и т. д.).

Используйте метод , Contains чтобы определить, существует ли столбец с предложенным именем в коллекции.

Если коллекция успешно изменена путем добавления или удаления столбцов, CollectionChanged происходит событие .

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

• ColumnName
• Contains(String)
• DataType
• Expression