DataColumnCollection.Add Метод

  • Ссылка

Определение

Пространство имен:
System.Data
Сборка:
System.Data.Common.dll
Сборка:
System.Data.dll
Сборка:
netstandard.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
Исходный код:
DataColumnCollection.cs
Исходный код:
DataColumnCollection.cs

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

Примеры

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

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

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

Add(DataColumn)

Исходный код:
DataColumnCollection.cs
Исходный код:
DataColumnCollection.cs
Исходный код:
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 происходит событие .

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

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

Add(String)

Исходный код:
DataColumnCollection.cs
Исходный код:
DataColumnCollection.cs
Исходный код:
DataColumnCollection.cs

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

Имя столбца.

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

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

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

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

Add(String, Type)

Исходный код:
DataColumnCollection.cs
Исходный код:
DataColumnCollection.cs
Исходный код:
DataColumnCollection.cs

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

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

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

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

Add(String, Type, String)

Исходный код:
DataColumnCollection.cs
Исходный код:
DataColumnCollection.cs
Исходный код:
DataColumnCollection.cs

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

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

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

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

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