ComboBox.ObjectCollection.Add メソッド

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

ComboBox.ObjectCollection.Add メソッド

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

ComboBox の項目のリストに項目を追加します。

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

Visual Basic (宣言)

Public Function Add ( _
    item As Object _
) As Integer

Visual Basic (使用法)

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

returnValue = instance.Add(item)

C#

public int Add (
    Object item
)

C++

public:
int Add (
    Object^ item
)

J#

public int Add (
    Object item
)

JScript

public function Add (
    item : Object
) : int

パラメータ

item

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

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

例外

例外の種類	条件
ArgumentNullException	item パラメータが null 参照 (Visual Basic では Nothing) でした。

解説

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

項目のビジュアルな表示がコンボ ボックスに表示されます。この内容表示は、DisplayMember プロパティで指定されています。DisplayMember プロパティが null 参照 (Visual Basic では Nothing) の場合は、項目の ToString メソッドが呼び出されて、コンボ ボックスで表示されている文字列を取得します。それ以外の場合は、DisplayMember プロパティで指定されたとおりに格納されているオブジェクトのプロパティが表示されます。新しい項目を格納するための領域が不足していると、SystemException が発生します。コンボ ボックスに項目のセットを追加するには、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
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

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