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 を作成してDataTableDataColumnCollection追加します。

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

メソッドを 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 は、既定の名前 ("Column1"、"Column2"など) が列に渡されます。

メソッドを 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 は、既定の名前 ("Column1"、"Column2"など) が列に渡されます。

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

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

こちらもご覧ください

• ColumnName
• Contains(String)
• DataType
• Expression