ListBox.FindStringExact Methode

Quelle:

ListBox.cs

Quelle:

ListBox.cs

Quelle:

ListBox.cs

Quelle:

ListBox.cs

Quelle:

ListBox.cs

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

public int FindStringExact(string s);

member this.FindStringExact : string -> int

Public Function FindStringExact (s As String) As Integer

Parameter

Gibt zurück

Der nullbasierte Index des ersten gefundenen Elements; gibt zurück ListBox.NoMatches , wenn keine Übereinstimmung gefunden wird.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie mithilfe der ListBox.FindStringExact Methode nach einem Steuerelement nach einem ListBox Element gesucht wird, das exakt einer angegebenen Zeichenfolge entspricht. Wenn keine Elemente gefunden werden, die der Suchzeichenfolge entsprechen, FindStringExact wird ein -1 Wert zurückgegeben, und im Beispiel wird ein MessageBox. Wenn ein Element gefunden wird, das dem Suchtext entspricht, verwendet das Beispiel die SetSelected Methode, um das Element in der ListBox.

private:
   void FindMySpecificString( String^ searchString )
   {
      // Ensure we have a proper string to search for.
      if ( searchString != String::Empty )
      {
         // Find the item in the list and store the index to the item.
         int index = listBox1->FindStringExact( searchString );

         // Determine if a valid index is returned. Select the item if it is valid.
         if ( index != ListBox::NoMatches )
                  listBox1->SetSelected( index, true );
         else
                  MessageBox::Show( "The search string did not find any items in the ListBox that exactly match the specified search string" );
      }
   }

private void FindMySpecificString(string searchString)
{
   // Ensure we have a proper string to search for.
   if (!string.IsNullOrEmpty(searchString))
   {
      // Find the item in the list and store the index to the item.
      int index = listBox1.FindStringExact(searchString);
      // Determine if a valid index is returned. Select the item if it is valid.
      if (index != ListBox.NoMatches)
         listBox1.SetSelected(index,true);
      else
         MessageBox.Show("The search string did not find any items in the ListBox that exactly match the specified search string");
   }
}

Private Sub FindMySpecificString(ByVal searchString As String)
   ' Ensure we have a proper string to search for.
   If searchString <> String.Empty Then
      ' Find the item in the list and store the index to the item.
      Dim index As Integer = listBox1.FindStringExact(searchString)
      ' Determine if a valid index is returned. Select the item if it is valid.
      If index <> ListBox.NoMatches Then
         listBox1.SetSelected(index, True)
      Else
         MessageBox.Show("The search string did not find any items in the ListBox that exactly match the specified search string")
      End If
   End If
End Sub

Hinweise

Bei der von dieser Methode durchgeführten Suche wird die Groß-/Kleinschreibung nicht beachtet. Die Suche sucht nach einer genauen Übereinstimmung mit den Wörtern, die im Suchzeichenfolgenparameter angegeben sind. s Mit dieser Methode können Sie nach dem ersten Element suchen, das der angegebenen Zeichenfolge entspricht. Anschließend können Sie Aufgaben wie das Entfernen des Elements ausführen, das den Suchtext enthält, indem Sie die Remove Methode verwenden oder den Text des Elements ändern. Nachdem Sie den angegebenen Text gefunden haben, können Sie, wenn Sie nach anderen Instanzen des Texts im ListBoxText suchen möchten, die Version der Methode verwenden, die FindStringExact einen Parameter zum Angeben eines Startindex in der ListBox. Wenn Sie eine teilweise Wortsuche anstelle einer exakten Wortabgleichung durchführen möchten, verwenden Sie die FindString Methode.

Weitere Informationen

• FindString(String)
• Contains(Object)

Quelle:

ListBox.cs

Quelle:

ListBox.cs

Quelle:

ListBox.cs

Quelle:

ListBox.cs

Quelle:

ListBox.cs

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

public int FindStringExact(string s, int startIndex);

member this.FindStringExact : string * int -> int

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

Parameter

Gibt zurück

Der nullbasierte Index des ersten gefundenen Elements; gibt zurück ListBox.NoMatches , wenn keine Übereinstimmung gefunden wird.

Ausnahmen

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie FindStringExact die Methode verwendet wird, um nach allen Elementen in einem ListBox Element zu suchen, das exakt mit dem angegebenen Suchtext übereinstimmt. Im Beispiel wird die Version der Methode verwendet, mit der FindStringExact Sie einen Startsuchindex angeben können, aus dem eine kontinuierliche Suche aller Elemente in der ListBoxDatei ausgeführt werden soll. Das Beispiel veranschaulicht außerdem, wie Sie bestimmen können, wann die FindStringExact Methode mit der Suche vom Anfang der Liste beginnt, nachdem sie das Ende der Liste der Elemente erreicht hat, um eine rekursive Suche zu verhindern. Sobald Elemente in der ListBoxDatei gefunden wurden, werden sie mithilfe der SetSelected Methode ausgewählt.

private:
   void FindAllOfMyExactStrings( String^ searchString )
   {
      // Set the SelectionMode property of the ListBox to select multiple items.
      listBox1->SelectionMode = SelectionMode::MultiExtended;

      // Set our intial index variable to -1.
      int x = -1;

      // If the search string is empty exit.
      if ( searchString->Length != 0 )
      {
         // Loop through and find each item that matches the search string.
         do
         {
            // Retrieve the item based on the previous index found. Starts with -1 which searches start.
            x = listBox1->FindStringExact( searchString, x );

            // If no item is found that matches exit.
            if ( x != -1 )
            {
               // Since the FindStringExact loops infinitely, determine if we found first item again and exit.
               if ( listBox1->SelectedIndices->Count > 0 )
               {
                  if ( x == listBox1->SelectedIndices[ 0 ] )
                                    return;
               }

               // Select the item in the ListBox once it is found.
               listBox1->SetSelected( x, true );
            }
         }
         while ( x != -1 );
      }
   }

private void FindAllOfMyExactStrings(string searchString)
{
   // Set the SelectionMode property of the ListBox to select multiple items.
   listBox1.SelectionMode = SelectionMode.MultiExtended;
   
   // Set our intial index variable to -1.
   int x =-1;
   // If the search string is empty exit.
   if (searchString.Length != 0)
   {
      // Loop through and find each item that matches the search string.
      do
      {
         // Retrieve the item based on the previous index found. Starts with -1 which searches start.
         x = listBox1.FindStringExact(searchString, x);
         // If no item is found that matches exit.
         if (x != -1)
         {
            // Since the FindStringExact loops infinitely, determine if we found first item again and exit.
            if (listBox1.SelectedIndices.Count > 0)
            {
               if (x == listBox1.SelectedIndices[0])
                  return;
            }
            // Select the item in the ListBox once it is found.
            listBox1.SetSelected(x,true);
         }
      }while(x != -1);
   }
}

Private Sub FindAllOfMyExactStrings(ByVal searchString As String)
   ' Set the SelectionMode property of the ListBox to select multiple items.
   ListBox1.SelectionMode = SelectionMode.MultiExtended

   ' Set our intial index variable to -1.
   Dim x As Integer = -1
   ' If the search string is empty exit.
   If searchString.Length <> 0 Then
      ' Loop through and find each item that matches the search string.
      Do
         ' Retrieve the item based on the previous index found. Starts with -1 which searches start.
         x = ListBox1.FindStringExact(searchString, x)
         ' If no item is found that matches exit.
         If x <> -1 Then
            ' Since the FindStringExact loops infinitely, determine if we found first item again and exit.
            If ListBox1.SelectedIndices.Count > 0 Then
               If x = ListBox1.SelectedIndices(0) Then
                  Return
               End If
            End If
            ' Select the item in the ListBox once it is found.
            ListBox1.SetSelected(x, True)
         End If
      Loop While x <> -1
   End If
End Sub

Hinweise

Bei der von dieser Methode durchgeführten Suche wird die Groß-/Kleinschreibung nicht beachtet. Die Suche sucht nach Wörtern, die exakt mit dem angegebenen Suchzeichenfolgenparameter übereinstimmen, s. Sie können diese Methode verwenden, um nach dem ersten Element zu suchen, das der angegebenen Zeichenfolge am angegebenen Anfangsindex innerhalb der Liste der Elemente für die ListBox. Anschließend können Sie Aufgaben ausführen, z. B. das Entfernen des Elements, das den Suchtext enthält, mithilfe der Remove Methode oder ändern den Text des Elements. Diese Methode wird in der Regel verwendet, nachdem ein Aufruf mit der Version dieser Methode erfolgt ist, die keinen Startindex angibt. Sobald ein anfängliches Element in der Liste gefunden wurde, wird diese Methode in der Regel verwendet, um weitere Instanzen des Suchtexts zu finden, indem die Indexposition im startIndex Parameter des Elements nach der ersten gefundenen Instanz des Suchtexts angegeben wird. Wenn Sie eine Teilwortsuche anstelle einer exakten Wortabgleichung durchführen möchten, verwenden Sie die FindString Methode.

Weitere Informationen

• FindString(String)
• Contains(Object)