DataColumnCollection.Add メソッド (String, Type, String)

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

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

パラメータ

• columnName
  列の作成時に使用する名前。
• type
  新しい列の DataType 。
• expression
  Expression プロパティに割り当てる式。

戻り値

新しく作成した DataColumn 。

例外

例外の種類	条件
DuplicateNameException	コレクションには、既に指定した名前の列があります。比較では、大文字と小文字が区別されません。
InvalidExpressionException	式が無効です。式の作成の詳細については、 Expression プロパティのトピックを参照してください。

解説

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 of a table in a DataSet.
    cols = DataSet1.Tables("Orders").Columns
    ' Add a new column and return it.
    myCol = cols.Add("Total", System.Type.GetType("System.Decimal"), _
       "Price + Tax")
    myCol.ReadOnly = True
    myCol.Unique = False
 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