DataColumnCollection.Add メソッド

定義

名前空間:: System.Data

アセンブリ:: System.Data.dll

アセンブリ:: netstandard.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

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

DataColumn オブジェクトを作成し、DataColumnCollectionに追加します。

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

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

public virtual System.Data.DataColumn Add();

public System.Data.DataColumn Add();

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

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

Public Overridable Function Add () As DataColumn

Public Function Add () As DataColumn

返品

DataColumn

新しく作成された DataColumn。

例

次の例では、DataTableのDataColumnCollectionに新しいDataColumnを作成して追加します。

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 イベントが発生します。

こちらもご覧ください

適用対象

Add(DataColumn)

指定した 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 プロパティを参照してください。

例

次の例では、DataColumnCollectionにDataColumnを追加します。

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)

指定した名前の DataColumn オブジェクトを作成し、 DataColumnCollectionに追加します。

public:
 virtual System::Data::DataColumn ^ Add(System::String ^ columnName);

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

public virtual System.Data.DataColumn Add(string columnName);

public System.Data.DataColumn Add(string columnName);

abstract member Add : string -> System.Data.DataColumn
override this.Add : string -> System.Data.DataColumn

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

Public Overridable Function Add (columnName As String) As DataColumn

Public Function Add (columnName As String) As DataColumn

パラメーター

columnName: String

列の名前。

返品

DataColumn

新しく作成された DataColumn。

例外

DuplicateNameException

コレクションには、指定した名前の列が既に含まれます。 (比較では大文字と小文字は区別されません)。

例

次の例では、DataTableのDataColumnCollectionに新しいDataColumnを作成して追加します。

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または空の文字列 ("") が名前に渡された場合、既定の名前 ("Column1"、"Column2"など) が列に渡されます。

Containsメソッドを使用して、提案された名前の列がコレクションに既に存在するかどうかを判断します。

列の追加または削除によってコレクションが正常に変更されると、 CollectionChanged イベントが発生します。

こちらもご覧ください

適用対象

Add(String, Type)

指定した名前と型を持つ DataColumn オブジェクトを作成し、 DataColumnCollectionに追加します。

public:
 virtual System::Data::DataColumn ^ Add(System::String ^ columnName, Type ^ type);

public:
 System::Data::DataColumn ^ Add(System::String ^ columnName, Type ^ type);

public virtual System.Data.DataColumn Add(string columnName, Type type);

public System.Data.DataColumn Add(string columnName, Type type);

abstract member Add : string * Type -> System.Data.DataColumn
override this.Add : string * Type -> System.Data.DataColumn

member this.Add : string * Type -> System.Data.DataColumn

Public Overridable Function Add (columnName As String, type As Type) As DataColumn

Public Function Add (columnName As String, type As Type) As DataColumn

パラメーター

columnName: String

列の作成時に使用する ColumnName 。

type: Type

新しい列の DataType 。

返品

DataColumn

新しく作成された DataColumn。

例外

DuplicateNameException

コレクションには、指定した名前の列が既に含まれます。 (比較では大文字と小文字は区別されません)。

InvalidExpressionException

式が無効です。式の作成方法の詳細については、 Expression プロパティを参照してください。

例

次の例では、DataTableのDataColumnCollectionに新しいDataColumnを作成して追加します。

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"、"Column2"など) が列に渡されます。

Containsメソッドを使用して、提案された名前の列がコレクションに既に存在するかどうかを判断します。

列の追加または削除によってコレクションが正常に変更されると、 CollectionChanged イベントが発生します。

こちらもご覧ください

適用対象

Add(String, Type, String)

指定した名前、型、および式を持つ DataColumn オブジェクトを作成し、 DataColumnCollectionに追加します。

public:
 virtual System::Data::DataColumn ^ Add(System::String ^ columnName, Type ^ type, System::String ^ expression);

public:
 System::Data::DataColumn ^ Add(System::String ^ columnName, Type ^ type, System::String ^ expression);

public virtual System.Data.DataColumn Add(string columnName, Type type, string expression);

public System.Data.DataColumn Add(string columnName, Type type, string expression);

abstract member Add : string * Type * string -> System.Data.DataColumn
override this.Add : string * Type * string -> System.Data.DataColumn

member this.Add : string * Type * string -> System.Data.DataColumn

Public Overridable Function Add (columnName As String, type As Type, expression As String) As 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 プロパティを参照してください。

例

次の例では、DataTableのDataColumnCollectionに新しいDataColumnを作成して追加します。

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"、"Column2"など) が列に渡されます。

Containsメソッドを使用して、提案された名前の列がコレクションに既に存在するかどうかを判断します。

列の追加または削除によってコレクションが正常に変更されると、 CollectionChanged イベントが発生します。

こちらもご覧ください

適用対象

フィードバック

このページはお役に立ちましたか?