ComboBox.ObjectCollection.AddRange メソッドとは何？わかりやすく解説 Weblio辞書

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

索引トップ用語の索引ランキング

ComboBox.ObjectCollection.AddRange メソッド

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

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

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

Visual Basic (宣言)

Public Sub AddRange ( _
    items As Object() _
)

Visual Basic (使用法)

Dim instance As ObjectCollection
Dim items As Object()

instance.AddRange(items)

public void AddRange (
    Object[] items
)

C++

public:
void AddRange (
    array<Object^>^ items
)

public void AddRange (
    Object[] items
)

JScript

public function AddRange (
    items : Object[]
)

パラメータ

items: リストに追加するオブジェクトの配列。

例外

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

解説

ComboBox の Sorted プロパティが true に設定されている場合は、項目がリストにアルファベット順で挿入されます。それ以外の場合、項目は配列内で発生した順序で挿入されます。通常は、このメソッドには String オブジェクトの配列が渡されますが、どの型のオブジェクトの配列でも渡すことができます。オブジェクトがコレクションに追加されると、このメソッドがオブジェクトの ToString メソッドを呼び出して、リストに表示する文字列を取得します。このメソッドを使用してコレクションに項目を追加するときは、BeginUpdate メソッドと EndUpdate メソッドを呼び出してパフォーマンスを最適化する必要はありません。

使用例

テキストプロパティを設定し、AddRange メソッドを使用して ComboBox に情報を読み込んで、ComboBox コントロールを初期化するコード例を次に示します。この例はまた、DropDown イベントの処理方法も示しています。この例を実行するには、次のコードをフォームに貼り付けて、フォームのコンストラクタまたは Load メソッドから InitializeComboBox メソッドを呼び出します。

Visual Basic

' Declare ComboBox1.
Friend WithEvents ComboBox1 As
 System.Windows.Forms.ComboBox

' Initialize ComboBox1.
Private Sub InitializeComboBox()
    Me.ComboBox1 = New ComboBox
    Me.ComboBox1.Location = New System.Drawing.Point(128,
 48)
    Me.ComboBox1.Name = "ComboBox1"
    Me.ComboBox1.Size = New System.Drawing.Size(100,
 21)
    Me.ComboBox1.TabIndex = 0
    Me.ComboBox1.Text = "Typical"
    Dim installs() As String
 = New String() _
        {"Typical", "Compact",
 "Custom"}
    ComboBox1.Items.AddRange(installs)
    Me.Controls.Add(Me.ComboBox1)
End Sub

' Handles the ComboBox1 DropDown event. If the user expands the  
' drop-down box, a message box will appear, recommending the
' typical installation.
Private Sub ComboBox1_DropDown _ 
    (ByVal sender As Object,
 ByVal e As System.EventArgs) _ 
    Handles ComboBox1.DropDown
    MessageBox.Show("Typical installation is strongly recommended.",
 _
    "Install information", MessageBoxButtons.OK, MessageBoxIcon.Information)
End Sub

// Declare ComboBox1.
internal System.Windows.Forms.ComboBox ComboBox1;

// Initialize ComboBox1.
private void InitializeComboBox()
{
    this.ComboBox1 = new ComboBox();
    this.ComboBox1.Location = new System.Drawing.Point(128,
 48);
    this.ComboBox1.Name = "ComboBox1";
    this.ComboBox1.Size = new System.Drawing.Size(100,
 21);
    this.ComboBox1.TabIndex = 0;
    this.ComboBox1.Text    = "Typical";
    string[] installs = new string[]{"Typical",
 "Compact", "Custom"};
    ComboBox1.Items.AddRange(installs);
    this.Controls.Add(this.ComboBox1);
    
    // Hook up the event handler.
    this.ComboBox1.DropDown +=  
        new System.EventHandler(ComboBox1_DropDown);
}

// Handles the ComboBox1 DropDown event. If the user expands the  
// drop-down box, a message box will appear, recommending the
// typical installation.
private void ComboBox1_DropDown(object sender,
 System.EventArgs e)
{
    MessageBox.Show("Typical installation is strongly recommended.", 
    "Install information", MessageBoxButtons.OK, 
        MessageBoxIcon.Information);
}

C++

internal:
   // Declare ComboBox1
   System::Windows::Forms::ComboBox^ ComboBox1;

private:
   // Initialize ComboBox1.
   void InitializeComboBox()
   {
      this->ComboBox1 = gcnew ComboBox;
      this->ComboBox1->Location = System::Drawing::Point(
 128, 48 );
      this->ComboBox1->Name = "ComboBox1";
      this->ComboBox1->Size = System::Drawing::Size( 100,
 21 );
      this->ComboBox1->TabIndex = 0;
      this->ComboBox1->Text = "Typical";
      array<String^>^ installs = {"Typical","Compact","Custom"};
      ComboBox1->Items->AddRange( installs );
      this->Controls->Add( this->ComboBox1
 );
      
      // Hook up the event handler.
      this->ComboBox1->DropDown += gcnew System::EventHandler(
         this, &Form1::ComboBox1_DropDown );
   }

   // Handles the ComboBox1 DropDown event. If the user expands the
  
   // drop-down box, a message box will appear, recommending the
   // typical installation.
   void ComboBox1_DropDown( Object^ sender, System::EventArgs^
 e )
   {
      MessageBox::Show( "Typical installation is strongly recommended."
,
         "Install information", MessageBoxButtons::OK,
         MessageBoxIcon::Information );
   }

// Declare comboBox1.
System.Windows.Forms.ComboBox comboBox1;

// Initialize comboBox1.
private void InitializeComboBox()
{
    this.comboBox1 = new ComboBox();
    this.comboBox1.set_Location(new System.Drawing.Point(128,
 48));
    this.comboBox1.set_Name("comboBox1");
    this.comboBox1.set_Size(new System.Drawing.Size(100,
 21));
    this.comboBox1.set_TabIndex(0);
    this.comboBox1.set_Text("Typical");
    String installs[] = new String[] { "Typical", "Compact",
 "Custom" };
    comboBox1.get_Items().AddRange(installs);
    this.get_Controls().Add(this.comboBox1);
    // Hook up the event handler.
    this.comboBox1.add_DropDown(new System.EventHandler(
        comboBox1_DropDown));
} //InitializeComboBox

// Handles the comboBox1 DropDown event. If the user expands the  
// drop-down box, a message box will appear, recommending the
// typical installation.
private void comboBox1_DropDown(Object sender,
 System.EventArgs e)
{
    MessageBox.Show("Typical installation is strongly recommended.", 
        "Install information", MessageBoxButtons.OK, 
        MessageBoxIcon.Information);
} //comboBox1_DropDown