次の方法で共有

DataColumnCollection.Add メソッド (String)

  • [アーティクル]

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

Overloads Public Overridable Function Add( _
   ByVal columnName As String _) As DataColumn
[C#]
public virtual DataColumn Add(stringcolumnName);
[C++]
public: virtual DataColumn* Add(String* columnName);
[JScript]
public function Add(
   columnName : String) : DataColumn;

パラメータ

  • columnName
    列の名前。

戻り値

新しく作成した DataColumn 。

例外

例外の種類 条件
DuplicateNameException コレクションには、既に指定した名前の列があります。比較では、大文字と小文字が区別されません。

解説

既定では、新しい列の DataType は文字列になります。

null 参照 (Visual Basic では Nothing) または空の文字列 ("") が名前として渡された場合は、この列に既定の名前 ("Column1"、"Column2" など) が指定されます。

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

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

使用例

[Visual Basic] 新しい DataColumn を作成し、 DataTable の DataColumnCollection に追加する例を次に示します。

 
Private Sub AddColumn()
    Dim cols As DataColumnCollection
    Dim myCol As DataColumn
    ' Get the DataColumnCollection from a table in a DataSet.
    cols = DataSet1.Tables("Prices").Columns
    myCol = cols.Add("Total")
    With myCol
       .DataType = System.Type.GetType("System.Decimal")
       .ReadOnly = True
       .Expression = "UnitPrice * Quantity"
       .Unique = False
    End With
 End Sub

[C#, C++, JScript] C#、C++、および JScript のサンプルはありません。Visual Basic のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン 言語のフィルタ をクリックします。

必要条件

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ, .NET Compact Framework - Windows CE .NET

参照

DataColumnCollection クラス | DataColumnCollection メンバ | System.Data 名前空間 | DataColumnCollection.Add オーバーロードの一覧 | ColumnName | Contains | DataType | Expression