DataColumnCollection.Add メソッド

リファレンス

定義

名前空間:: System.Data

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

アセンブリ:: 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()

ソース:: 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 を作成してDataTable DataColumnCollection追加します。

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)

ソース:: 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 プロパティのトピックを参照してください。

例

次の例では、を 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 発生します。

こちらもご覧ください

適用対象

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

ソース:: 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 をDataColumnCollection DataTable追加します。

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)

ソース:: 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 をDataColumnCollection DataTable追加します。

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 発生します。

こちらもご覧ください

適用対象

次の方法で共有

DataColumnCollection.Add メソッド

定義

オーバーロード

Add()

戻り値

例

注釈

こちらもご覧ください

適用対象

Add(DataColumn)

パラメーター

例外

例

注釈

こちらもご覧ください

適用対象

Add(String)

パラメーター

戻り値

例外

例

注釈

こちらもご覧ください

適用対象

Add(String, Type)

パラメーター

戻り値

例外

例

注釈

こちらもご覧ください

適用対象

Add(String, Type, String)

パラメーター

戻り値

例外

例

注釈

こちらもご覧ください

適用対象

その他のリソース