ComboBox.ObjectCollection.System.Collections.IList.Add メソッド

.NET Framework クラス ライブラリ リファレンス

ComboBox.ObjectCollection.System.Collections.IList.Add メソッド

このメソッドは、.NET Framework インフラストラクチャをサポートします。独自に作成したコードから直接使用するためのものではありません。

このメンバの説明については、IList.Add のトピックを参照してください。

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文

Visual Basic (宣言)

Private Function System.Collections.IList.Add
 ( _
    item As Object _
) As Integer Implements
 IList.Add

Visual Basic (使用法)

Dim instance As ObjectCollection
Dim item As Object
Dim returnValue As Integer

returnValue = CType(instance, IList).Add(item)

C#

int IList.Add (
    Object item
)

C++

private:
virtual int System.Collections.IList.Add (
    Object^ item
) sealed = IList::Add

J#

J# では、明示的なインタフェースの実装は使用できますが、新規に宣言することはできません。

JScript

JScript では、明示的なインタフェースの実装は使用できますが、新規に宣言することはできません。

パラメータ

item

コレクションに追加する項目を表すオブジェクト。

戻り値
コレクション内の項目の 0 から始まるインデックス番号。

例外

例外の種類	条件
ArgumentNullException	item パラメータが null 参照 (Visual Basic では Nothing) です。
SystemException	新しい項目を格納するための領域が不足しています。

解説

このメンバは、明示的なインターフェイス メンバの実装です。ComboBox.ObjectCollection インスタンスが IList インターフェイスにキャストされた場合にのみ使用できます。

このメソッドはコンボ ボックスに項目を追加します。ComboBox の Sorted プロパティが true に設定されていると、項目がリストにアルファベット順で挿入されます。それ以外の場合、項目はリストの末尾に挿入されます。

項目のビジュアルな表示がコンボ ボックスに表示されます。この内容表示は、DisplayMember プロパティで指定されています。DisplayMember プロパティが null 参照 (Visual Basic では Nothing) の場合は、項目の ToString メソッドが呼び出されて、コンボ ボックスで表示されている文字列を取得します。それ以外の場合は、DisplayMember プロパティで指定されたとおりに格納されているオブジェクトのプロパティが表示されます。コンボ ボックスに項目のセットを追加するには、AddRange メソッドを使用すると便利です。Add メソッドを使用してコンボ ボックスに項目のセットを追加する場合は、BeginUpdate メソッドを使用して追加中の再描画を中断します。再描画を再開するには EndUpdate メソッドを使用します。Insert メソッドを使用して、リスト内のどの位置に項目を追加するかを指定できます。オブジェクトがコレクションに追加されると、ComboBox がオブジェクトの ToString メソッドを呼び出して、リストに表示する文字列を取得します。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
ComboBox.ObjectCollection クラス
ComboBox.ObjectCollection メンバ
System.Windows.Forms 名前空間
IList