ListBox.FindStringExact Metodo

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

public int FindStringExact(string s);

member this.FindStringExact : string -> int

Public Function FindStringExact (s As String) As Integer

Parametri

Valori restituiti

Indice in base zero del primo elemento trovato; restituisce ListBox.NoMatches se non viene trovata alcuna corrispondenza.

Esempio

Nell'esempio di codice seguente viene illustrato come utilizzare il ListBox.FindStringExact metodo per cercare un controllo per un ListBox elemento che corrisponde esattamente a una stringa specificata. Se non vengono trovati elementi che corrispondono alla stringa di ricerca, FindStringExact restituisce un valore -1 e nell'esempio viene visualizzato un oggetto MessageBox. Se viene trovato un elemento che corrisponde al testo di ricerca, nell'esempio viene usato il SetSelected metodo per selezionare l'elemento in 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

Commenti

La ricerca eseguita da questo metodo non fa distinzione tra maiuscole e minuscole. La ricerca cerca una corrispondenza esatta con le parole specificate nel parametro della stringa di ricerca, s. È possibile utilizzare questo metodo per cercare il primo elemento che corrisponde alla stringa specificata. È quindi possibile eseguire attività come la rimozione dell'elemento che contiene il testo di ricerca usando il Remove metodo o modificando il testo dell'elemento. Dopo aver trovato il testo specificato, se si desidera cercare altre istanze del testo in ListBox, è possibile usare la versione del FindStringExact metodo che fornisce un parametro per specificare un indice iniziale all'interno di ListBox. Se si desidera eseguire una ricerca parziale delle parole anziché una corrispondenza esatta di parole, usare il FindString metodo .

Vedi anche

• FindString(String)
• Contains(Object)

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

Parametri

Valori restituiti

Indice in base zero del primo elemento trovato; restituisce ListBox.NoMatches se non viene trovata alcuna corrispondenza.

Eccezioni

Esempio

Nell'esempio di codice seguente viene illustrato come utilizzare il FindStringExact metodo per cercare tutti gli elementi in un oggetto ListBox che corrisponda esattamente al testo di ricerca specificato. Nell'esempio viene utilizzata la versione del FindStringExact metodo che consente di specificare un indice di ricerca iniziale da cui eseguire una ricerca continua di tutti gli elementi in ListBox. Nell'esempio viene inoltre illustrato come determinare quando il metodo inizia la FindStringExact ricerca dalla parte superiore dell'elenco dopo che raggiunge la fine dell'elenco di elementi, per evitare una ricerca ricorsiva. Dopo aver trovato gli elementi in ListBox, vengono selezionati usando il SetSelected metodo .

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

Commenti

La ricerca eseguita da questo metodo non fa distinzione tra maiuscole e minuscole. La ricerca cerca parole che corrispondono esattamente al parametro della stringa di ricerca specificato, s. È possibile utilizzare questo metodo per cercare il primo elemento che corrisponde alla stringa specificata in corrispondenza dell'indice iniziale specificato all'interno dell'elenco di elementi per .ListBox È quindi possibile eseguire attività come la rimozione dell'elemento che contiene il testo di ricerca usando il Remove metodo o modificare il testo dell'elemento. Questo metodo viene in genere utilizzato dopo che è stata effettuata una chiamata utilizzando la versione di questo metodo che non specifica un indice iniziale. Dopo aver trovato un elemento iniziale nell'elenco, questo metodo viene in genere usato per trovare altre istanze del testo di ricerca specificando la posizione di indice nel startIndex parametro dell'elemento dopo la prima istanza trovata del testo di ricerca. Se si desidera eseguire una ricerca di parole parziale anziché una corrispondenza esatta di parole, utilizzare il FindString metodo .

Vedi anche

• FindString(String)
• Contains(Object)