DataColumnCollection.Add Метод

Определение

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

System.Data

Сборки:

netstandard.dll, 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

Комментарии

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

Если коллекция успешно изменена путем добавления или удаления столбцов, 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 свойстве.

Примеры

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

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

• 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);

[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Members might be trimmed for some data types or expressions.")]
public System.Data.DataColumn Add(string? columnName, Type type, string expression);

[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Members might be trimmed for some data types or expressions.")>]
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.

Атрибуты

RequiresUnreferencedCodeAttribute

Исключения

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