ComboBox.FindString 메서드

정의

네임스페이스:

System.Windows.Forms

어셈블리:

System.Windows.Forms.dll

지정된 문자열로 시작하는 ComboBox에서 첫 번째 항목의 인덱스를 반환합니다.

오버로드

FindString(String)	지정된 문자열로 시작하는 ComboBox에서 첫 번째 항목의 인덱스를 반환합니다.
FindString(String, Int32)	지정된 문자열이 포함된 지정된 인덱스 이후의 ComboBox에서 첫 번째 항목의 인덱스를 반환합니다. 검색은 대/소문자를 구분하지 않습니다.

FindString(String)

지정된 문자열로 시작하는 ComboBox에서 첫 번째 항목의 인덱스를 반환합니다.

public:
 int FindString(System::String ^ s);

public int FindString (string? s);

member this.FindString : string -> int

Public Function FindString (s As String) As Integer

매개 변수

s

String

검색할 String입니다.

반환

Int32

찾은 첫째 항목의 0부터 시작하는 인덱스입니다. 일치하는 항목이 없으면 -1을 반환합니다.

예제

다음 코드 예제에서는 메서드 및 속성의 FindString 사용을 보여 줍니다 SelectedIndex . 이 예제는 클래스 개요의 전체 코드 예제의 ComboBox 일부입니다.

void findButton_Click( Object^ sender, System::EventArgs^ e )
{
   int index = comboBox1->FindString( textBox2->Text );
   comboBox1->SelectedIndex = index;
}

private void findButton_Click(object sender, System.EventArgs e) {
    int index = comboBox1.FindString(textBox2.Text);
    comboBox1.SelectedIndex = index;
}

Private Sub findButton_Click(ByVal sender As Object, ByVal e As System.EventArgs)
    Dim index As Integer
    index = comboBox1.FindString(textBox2.Text)
    comboBox1.SelectedIndex = index
End Sub

설명

이 메서드에서 수행하는 검색은 대/소문자를 구분하지 않습니다. s 매개 변수는 콤보 상자 목록의 항목과 연결된 텍스트와 비교할 부분 문자열입니다. 검색은 텍스트의 시작 부분에서 시작하여 지정된 부분 문자열과 일치하는 목록의 첫 번째 항목을 반환하는 부분 일치를 수행합니다. 그런 다음 메서드를 사용하여 Remove 검색 텍스트가 포함된 항목을 제거하거나 항목의 텍스트를 변경하는 등의 작업을 수행할 수 있습니다. 지정된 텍스트를 찾은 후 에서 ComboBox텍스트의 다른 인스턴스를 검색하려면 내에서 ComboBox시작 인덱스를 지정하기 위한 매개 변수를 제공하는 메서드의 FindString 버전을 사용해야 합니다. 부분 일치 대신 정확한 단어 일치를 검색하려면 메서드를 FindStringExact 사용합니다.

FindString(String, Int32)

지정된 문자열이 포함된 지정된 인덱스 이후의 ComboBox에서 첫 번째 항목의 인덱스를 반환합니다. 검색은 대/소문자를 구분하지 않습니다.

public:
 int FindString(System::String ^ s, int startIndex);

public int FindString (string? s, int startIndex);

member this.FindString : string * int -> int

Public Function FindString (s As String, startIndex As Integer) As Integer

매개 변수

s

String

검색할 String입니다.

startIndex

Int32

검색될 첫째 항목 앞에 나오는 항목의 0부터 시작하는 인덱스입니다. 컨트롤의 처음부터 검색하려면 -1로 설정합니다.

반환

Int32

찾은 첫 번째 항목의 인덱스(0부터 시작)입니다. 일치하는 항목이 없으면 -1을 반환하고, s 매개 변수가 Empty을(를) 지정하면 0을 반환합니다.

예외

ArgumentOutOfRangeException

startIndex가 -1보다 작습니다.

또는

startIndex가 컬렉션의 마지막 인덱스보다 큰 경우

설명

이 메서드에서 수행하는 검색은 대/소문자를 구분하지 않습니다. s 매개 변수는 콤보 상자 목록의 항목과 연결된 텍스트와 비교할 부분 문자열입니다. 검색은 텍스트의 시작부터 부분 일치를 수행하여 목록에서 지정된 부분 문자열과 일치하는 첫 번째 항목을 반환합니다. 그런 다음 메서드를 사용하여 Remove 검색 텍스트가 포함된 항목을 제거하거나 항목의 텍스트를 변경하는 등의 작업을 수행할 수 있습니다. 이 메서드는 일반적으로 시작 인덱스 지정 하지 않는이 메서드의 버전을 사용 하 여 호출 된 후 사용 합니다. 목록에서 초기 항목이 발견되면 이 메서드는 일반적으로 검색 텍스트의 첫 번째 instance 후 항목의 매개 변수에 startIndex 인덱스 위치를 지정하여 검색 텍스트의 추가 인스턴스를 찾는 데 사용됩니다. 부분 일치 대신 정확한 단어 일치를 검색하려면 메서드를 FindStringExact 사용합니다.