ComboBox.ObjectCollection.AddRange(Object[]) ComboBox.ObjectCollection.AddRange(Object[]) ComboBox.ObjectCollection.AddRange(Object[]) ComboBox.ObjectCollection.AddRange(Object[]) Method

정의

ComboBox의 항목 목록에 항목 배열을 추가합니다.Adds an array of items to the list of items for a ComboBox.

public:
 void AddRange(cli::array <System::Object ^> ^ items);
public void AddRange (object[] items);
member this.AddRange : obj[] -> unit
Public Sub AddRange (items As Object())

매개 변수

items
Object[]

목록에 추가할 개체 배열입니다.An array of objects to add to the list.

예외

items 매개 변수의 항목이 null인 경우An item in the items parameter was null.

예제

다음 코드 예제에는 초기화 하는 방법을 보여 줍니다.는 ComboBox text 속성을 설정 하 고 컨트롤을 AddRange 9e4af80fa7c0">getroot() 메서드를를 ComboBox.The following code example demonstrates how to initialize a ComboBox control by setting the text property and using the AddRange method to populate the ComboBox. 처리 하는 방법도 보여 줍니다는 DropDown 이벤트입니다.It also demonstrates handling the DropDown event. 예제를 실행 하려면 호출을 폼에 다음 코드를 붙여 합니다 InitializeComboBox 폼의 생성자에서 메서드 또는 Load 메서드.To run the example, paste the following code in a form and call the InitializeComboBox method from the form's constructor or Load method.

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.
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);
}

' 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

설명

경우는 Sorted 의 속성을 ComboBox 로 설정 된 true 이면 항목은 목록에 삽입 사전순으로 합니다.If the Sorted property of the ComboBox is set to true, the items are inserted into the list alphabetically. 그렇지 않으면 항목 배열 내에서 나타나는 순서에 삽입 됩니다.Otherwise, the items are inserted in the order they occur within the array. 이 메서드는 일반적으로 배열을 전달 String 개체가 아니라 모든 형식의 개체 배열을이 메서드에 전달할 수 있습니다.This method is typically passed an array of String objects, but an array of any type of object can be passed to this method. 호출 개체의 개체 컬렉션에 추가 되 면 ToString 메서드 목록에 표시할 문자열입니다.When an object is added to the collection, the method calls the object's ToString method to obtain the string to display in the list. 이 메서드를 사용 하 여 컬렉션에 항목 추가 필요가 없습니다를 호출 하는 BeginUpdateEndUpdate 성능을 최적화 하는 방법입니다.When using this method to add items to the collection, you do not need to call the BeginUpdate and EndUpdate methods to optimize performance.

적용 대상