Freigeben über


RichTextBox.Find Methode

Definition

Durchsucht den Inhalt der RichTextBox nach Text.

Überlädt

Find(Char[])

Durchsucht den Text eines RichTextBox-Steuerelements nach der ersten Instanz eines Zeichens aus einer Liste von Zeichen.

Find(String)

Durchsucht den Text in einem RichTextBox-Steuerelement nach einer Zeichenfolge.

Find(Char[], Int32)

Durchsucht den Text eines RichTextBox-Steuerelements ab einem bestimmten Anfangspunkt nach der ersten Instanz eines Zeichens aus einer Zeichenliste.

Find(String, RichTextBoxFinds)

Durchsucht den Text in einem RichTextBox-Steuerelement mit spezifischen Suchoptionen nach einer Zeichenfolge.

Find(Char[], Int32, Int32)

Durchsucht einen Textbereich in einem RichTextBox-Steuerelement nach der ersten Instanz eines Zeichens aus einer Liste von Zeichen.

Find(String, Int32, RichTextBoxFinds)

Durchsucht den Text in einem RichTextBox-Steuerelement nach einer Zeichenfolge an einer bestimmten Position im Steuerelement und mit spezifischen Suchoptionen.

Find(String, Int32, Int32, RichTextBoxFinds)

Durchsucht den Text in einem RichTextBox-Steuerelement nach einer Zeichenfolge innerhalb eines bestimmten Textbereichs im Steuerelement und mit spezifischen Suchoptionen.

Find(Char[])

Durchsucht den Text eines RichTextBox-Steuerelements nach der ersten Instanz eines Zeichens aus einer Liste von Zeichen.

public:
 int Find(cli::array <char> ^ characterSet);
public int Find (char[] characterSet);
member this.Find : char[] -> int
Public Function Find (characterSet As Char()) As Integer

Parameter

characterSet
Char[]

Das zu suchende Array von Zeichen.

Gibt zurück

Die Position innerhalb des Steuerelements, an der die zu suchenden Zeichen gefunden wurden, oder -1, wenn die Gruppe zu suchender Zeichen nicht gefunden wurde oder im char-Parameter eine leere Gruppe zu suchender Zeichen angegeben wurde.

Beispiele

Im folgenden Codebeispiel wird der Inhalt eines RichTextBox nach den Zeichen durchsucht, die im text Parameter an die -Methode übergeben werden. Wenn der Inhalt des text Arrays in RichTextBoxgefunden wird, gibt die Methode den Index des gefundenen Werts zurück, andernfalls gibt sie -1 zurück. Das Beispiel erfordert, dass diese Methode in der Klasse eines Form platziert wird, das ein RichTextBox Steuerelement mit dem Namen richTextBox1 und ein Button Steuerelement mit dem Namen enthält button1, das mit dem Click im Beispiel definierten Ereignishandler verbunden ist.

private:
   void button1_Click( Object^ /*sender*/, System::EventArgs^ /*e*/ )
   {
      array<Char>^temp1 = {'D','e','l','t','a'};
      MessageBox::Show( FindMyText( temp1 ).ToString() );
   }

public:
   int FindMyText( array<Char>^text )
   {
      // Initialize the return value to false by default.
      int returnValue = -1;

      // Ensure that a search string has been specified and a valid start point.
      if ( text->Length > 0 )
      {
         // Obtain the location of the first character found in the control
         // that matches any of the characters in the char array.
         int indexToText = richTextBox1->Find( text );

         // Determine whether the text was found in richTextBox1.
         if ( indexToText >= 0 )
         {
            // Return the location of the character.
            returnValue = indexToText;
         }
      }

      return returnValue;
   }
private void button1_Click(object sender, System.EventArgs e)
{
    MessageBox.Show(FindMyText(new char[]{'D','e','l','t','a'}).ToString());
}

public int FindMyText(char[] text)
{
    // Initialize the return value to false by default.
    int returnValue = -1;

    // Ensure that a search string has been specified and a valid start point.
    if (text.Length > 0) 
    {
        // Obtain the location of the first character found in the control
        // that matches any of the characters in the char array.
        int indexToText = richTextBox1.Find(text);
        // Determine whether the text was found in richTextBox1.
        if(indexToText >= 0)
        {
            // Return the location of the character.
            returnValue = indexToText;
        }
    }

    return returnValue;
}
Private Sub button1_Click(ByVal sender As Object, ByVal e As System.EventArgs) Handles button1.Click
    MessageBox.Show(FindMyText(New Char() {"B"c, "r"c, "a"c, "v"c, "o"c}).ToString())
End Sub


Public Function FindMyText(ByVal [text]() As Char) As Integer
    ' Initialize the return value to false by default.
    Dim returnValue As Integer = -1

    ' Ensure that a search string has been specified and a valid start point.
    If [text].Length > 0 Then
        ' Obtain the location of the first character found in the control
        ' that matches any of the characters in the char array.
        Dim indexToText As Integer = richTextBox1.Find([text])
        ' Determine whether the text was found in richTextBox1.
        If indexToText >= 0 Then
            ' Return the location of the character.
            returnValue = indexToText
        End If
    End If

    Return returnValue
End Function

Hinweise

Diese Version der Find Methode sucht nach dem ersten instance eines Zeichens aus einer Liste von Zeichen, die characterSet im Parameter angegeben sind, und gibt den Speicherort des Zeichens zurück. Beispielsweise übergeben Sie ein Array von Zeichen, das das Zeichen "Q" enthält. Wenn das Steuerelement den Text "The Quick Brown Fox" enthält, würde die Find Methode den Wert vier zurückgeben. Ein Großbuchstaben und ein Kleinbuchstaben werden in der Suche als unterschiedliche Werte betrachtet.

Wenn die -Eigenschaft einen negativen Wert zurückgibt, wurden die gesuchten Zeichen im Inhalt des Steuerelements nicht gefunden. Sie können diese Methode verwenden, um im Steuerelement nach einer Gruppe von Zeichen zu suchen. Diese Version der Find Methode erfordert, dass das gesamte dokument im Steuerelement nach den Zeichen gesucht wird. Wenn ein Zeichen aus der Zeichenliste gefunden wird, die im Parameter der Methode characterSet angegeben ist, ist der von dieser Methode zurückgegebene Wert ein nullbasierter Index der Position des Zeichens im Steuerelement. Ein Leerzeichen wird von der -Methode als Zeichen betrachtet, wenn die Position eines Zeichens bestimmt wird.

Gilt für:

Find(String)

Durchsucht den Text in einem RichTextBox-Steuerelement nach einer Zeichenfolge.

public:
 int Find(System::String ^ str);
public int Find (string str);
member this.Find : string -> int
Public Function Find (str As String) As Integer

Parameter

str
String

Der im Steuerelement zu suchende Text.

Gibt zurück

Die Position innerhalb des Steuerelements, an der der Suchtext gefunden wurde, oder -1, wenn die Suchzeichenfolge nicht gefunden wurde oder im str-Parameter eine leere Suchzeichenfolge angegeben wurde.

Beispiele

Im folgenden Codebeispiel wird der gesamte Inhalt einer RichTextBox nach dem ersten instance einer Suchzeichenfolge durchsucht, die an den Textparameter der -Methode übergeben wird. Wenn die Suchzeichenfolge in RichTextBoxgefunden wird, gibt die -Methode den Wert von true zurück und hebt den Suchtext hervor, andernfalls wird zurückgegeben false. Das Beispiel erfordert, dass diese Methode in der Klasse eines Form platziert wird, die einen RichTextBox namens richTextBox1enthält.

public:
   bool FindMyText( String^ text )
   {
      // Initialize the return value to false by default.
      bool returnValue = false;
      
      // Ensure a search string has been specified.
      if ( text->Length > 0 )
      {
         // Obtain the location of the search string in richTextBox1.
         int indexToText = richTextBox1->Find( text );
         // Determine whether the text was found in richTextBox1.
         if ( indexToText >= 0 )
         {
            returnValue = true;
         }
      }

      return returnValue;
   }
public bool FindMyText(string text)
{
   // Initialize the return value to false by default.
   bool returnValue = false;

   // Ensure a search string has been specified.
   if (text.Length > 0) 
   {
      // Obtain the location of the search string in richTextBox1.
      int indexToText = richTextBox1.Find(text);
      // Determine whether the text was found in richTextBox1.
      if(indexToText >= 0)
      {
         returnValue = true;
      }
   }

   return returnValue;
}
Public Function FindMyText(text As String) As Boolean
    ' Initialize the return value to false by default.
    Dim returnValue As Boolean = False
    
    ' Ensure a search string has been specified.
    If text.Length > 0 Then
        ' Obtain the location of the search string in richTextBox1.
        Dim indexToText As Integer = richTextBox1.Find(text)
        ' Determine whether the text was found in richTextBox1.
        If indexToText >= 0 Then
            returnValue = True
        End If
    End If
    
    Return returnValue
End Function

Hinweise

Die Find -Methode sucht nach dem im str -Parameter angegebenen Text und gibt die Position des ersten Zeichens im Steuerelement zurück. Wenn die -Eigenschaft einen negativen Wert zurückgibt, wurde die gesuchte Textzeichenfolge nicht im Inhalt des Steuerelements gefunden. Mit dieser Methode können Sie Suchfunktionen erstellen, die dem Benutzer des Steuerelements zur Verfügung gestellt werden können. Sie können diese Methode auch verwenden, um nach Text zu suchen, der durch ein bestimmtes Format ersetzt werden soll. Wenn der Benutzer beispielsweise Datumsangaben in das Steuerelement eingegeben hat, können Sie die Find -Methode verwenden, um nach allen Datumsangaben im Dokument zu suchen und sie durch das entsprechende Format zu ersetzen, bevor Sie die SaveFile -Methode des Steuerelements verwenden.

Hinweis

Die Find Methoden, die einen string als Parameter akzeptieren, können keinen Text finden, der in mehr als einer Textzeile in der RichTextBoxenthalten ist. Wenn Sie eine solche Suche ausführen, wird der Wert negativ (-1) zurückgegeben.

Gilt für:

Find(Char[], Int32)

Durchsucht den Text eines RichTextBox-Steuerelements ab einem bestimmten Anfangspunkt nach der ersten Instanz eines Zeichens aus einer Zeichenliste.

public:
 int Find(cli::array <char> ^ characterSet, int start);
public int Find (char[] characterSet, int start);
member this.Find : char[] * int -> int
Public Function Find (characterSet As Char(), start As Integer) As Integer

Parameter

characterSet
Char[]

Das zu suchende Array von Zeichen.

start
Int32

Die Position im Text des Steuerelements, an der die Suche begonnen werden soll.

Gibt zurück

Die Position im Steuerelement, an der die zu suchenden Zeichen gefunden wurden.

Beispiele

Im folgenden Codebeispiel wird der Inhalt eines RichTextBox nach den Zeichen durchsucht, die im text Parameter an die -Methode übergeben werden. Die Suche beginnt an der Position innerhalb des RichTextBox durch den start -Parameter der FindMyText -Methode angegebenen Speicherorts. Wenn der Inhalt des Textarrays in RichTextBoxgefunden wird, gibt die Methode den Index des gefundenen Werts zurück, andernfalls gibt sie -1 zurück. Das Beispiel erfordert, dass diese Methode in der Klasse eines Form platziert wird, das ein RichTextBox Steuerelement mit dem Namen richTextBox1 und ein Button Steuerelement namens button1 enthält, das mit dem Click im Beispiel definierten Ereignishandler verbunden ist.

private:
   void button1_Click( Object^ /*sender*/, System::EventArgs^ /*e*/ )
   {
      array<Char>^temp0 = {'B','r','a','v','o'};
      MessageBox::Show( FindMyText( temp0, 5 ).ToString() );
   }

public:
   int FindMyText( array<Char>^text, int start )
   {
      // Initialize the return value to false by default.
      int returnValue = -1;

      // Ensure that a valid char array has been specified and a valid start point.
      if ( text->Length > 0 && start >= 0 )
      {
         // Obtain the location of the first character found in the control
         // that matches any of the characters in the char array.
         int indexToText = richTextBox1->Find( text, start );

         // Determine whether any of the chars are found in richTextBox1.
         if ( indexToText >= 0 )
         {
            // Return the location of the character.
            returnValue = indexToText;
         }
      }

      return returnValue;
   }
private void button1_Click(object sender, System.EventArgs e)
{
    MessageBox.Show(FindMyText(new char[]{'B','r','a','v','o'}, 5).ToString());
}

public int FindMyText(char[] text, int start)
{
    // Initialize the return value to false by default.
    int returnValue = -1;

    // Ensure that a valid char array has been specified and a valid start point.
    if (text.Length > 0 && start >= 0) 
    {
        // Obtain the location of the first character found in the control
        // that matches any of the characters in the char array.
        int indexToText = richTextBox1.Find(text, start);
        // Determine whether any of the chars are found in richTextBox1.
        if(indexToText >= 0)
        {
            // Return the location of the character.
            returnValue = indexToText;
        }
    }

    return returnValue;
}
Private Sub button1_Click(ByVal sender As Object, ByVal e As System.EventArgs) Handles button1.Click
    MessageBox.Show(FindMyText(New Char() {"B"c, "r"c, "a"c, "v"c, "o"c}, 5).ToString())
End Sub


Public Function FindMyText(ByVal text() As Char, ByVal start As Integer) As Integer
    ' Initialize the return value to false by default.
    Dim returnValue As Integer = -1

    ' Ensure that a valid char array has been specified and a valid start point.
    If [text].Length > 0 And start >= 0 Then
        ' Obtain the location of the first character found in the control
        ' that matches any of the characters in the char array.
        Dim indexToText As Integer = richTextBox1.Find([text], start)
        ' Determine whether any of the chars are found in richTextBox1.
        If indexToText >= 0 Then
            ' Return the location of the character.
            returnValue = indexToText
        End If
    End If

    Return returnValue
End Function

Hinweise

Diese Version der Find -Methode sucht nach dem ersten instance eines Zeichens aus einer Liste von Zeichen, die characterSet im Parameter angegeben sind, und gibt den Speicherort des Zeichens zurück. Beispielsweise übergeben Sie ein Array von Zeichen, das das Zeichen "Q" enthält. Wenn das Steuerelement den Text "The Quick Brown Fox" enthält, würde die Find Methode den Wert vier zurückgeben. Ein Großbuchstaben und ein Kleinbuchstaben werden in der Suche als unterschiedliche Werte betrachtet.

Wenn die -Eigenschaft einen negativen Wert zurückgibt, wurden die gesuchten Zeichen im Inhalt des Steuerelements nicht gefunden. Sie können diese Methode verwenden, um im Steuerelement nach einer Gruppe von Zeichen zu suchen. Wenn ein Zeichen aus der Zeichenliste gefunden wird, die im Parameter der Methode characterSet angegeben ist, ist der von dieser Methode zurückgegebene Wert ein nullbasierter Index der Position des Zeichens im Steuerelement. Ein Leerzeichen wird von der -Methode als Zeichen betrachtet, wenn die Position eines Zeichens bestimmt wird.

Mit dieser Version der Find -Methode können Sie nach einem Zeichensatz von einer angegebenen Startposition im Text des Steuerelements suchen, indem Sie einen Wert für den start Parameter angeben. Der Wert 0 gibt an, dass die Suche am Anfang des Dokuments des Steuerelements beginnen soll. Sie können diese Version der Find -Methode verwenden, um Ihre Suche einzuschränken, um Text zu vermeiden, von dem Sie wissen, dass er nicht die angegebenen Zeichen enthält, nach denen Sie suchen oder in Der Suche nicht wichtig sind.

Gilt für:

Find(String, RichTextBoxFinds)

Durchsucht den Text in einem RichTextBox-Steuerelement mit spezifischen Suchoptionen nach einer Zeichenfolge.

public:
 int Find(System::String ^ str, System::Windows::Forms::RichTextBoxFinds options);
public int Find (string str, System.Windows.Forms.RichTextBoxFinds options);
member this.Find : string * System.Windows.Forms.RichTextBoxFinds -> int
Public Function Find (str As String, options As RichTextBoxFinds) As Integer

Parameter

str
String

Der im Steuerelement zu suchende Text.

options
RichTextBoxFinds

Eine bitweise Kombination der RichTextBoxFinds-Werte.

Gibt zurück

Die Position im Steuerelement, an der der Suchtext gefunden wurde.

Beispiele

Im folgenden Codebeispiel wird der gesamte Inhalt einer RichTextBox nach dem ersten instance einer Suchzeichenfolge durchsucht, die an den Textparameter der -Methode übergeben wird. Wenn die Suchzeichenfolge in gefunden wird, gibt die RichTextBox-Methode den Wert von true zurück und hebt den Text hervor, andernfalls wird zurückgegeben false. Das Beispiel gibt auch Optionen in der Suche an, die der Groß-/Kleinschreibung der angegebenen Suchzeichenfolge entsprechen. Das Beispiel erfordert, dass diese Methode in der Klasse eines Form platziert wird, die einen RichTextBox namens richTextBox1enthält.

public:
   bool FindMyText( String^ text )
   {
      // Initialize the return value to false by default.
      bool returnValue = false;
      
      // Ensure a search string has been specified.
      if ( text->Length > 0 )
      {
         // Obtain the location of the search string in richTextBox1.
         int indexToText = richTextBox1->Find( text, RichTextBoxFinds::MatchCase );
         // Determine if the text was found in richTextBox1.
         if ( indexToText >= 0 )
         {
            returnValue = true;
         }
      }

      return returnValue;
   }
public bool FindMyText(string text)
{
   // Initialize the return value to false by default.
   bool returnValue = false;

   // Ensure a search string has been specified.
   if (text.Length > 0) 
   {
      // Obtain the location of the search string in richTextBox1.
      int indexToText = richTextBox1.Find(text, RichTextBoxFinds.MatchCase);
      // Determine if the text was found in richTextBox1.
      if(indexToText >= 0)
      {
         returnValue = true;
      }
   }

   return returnValue;
}
Public Function FindMyText(text As String) As Boolean
    ' Initialize the return value to false by default.
    Dim returnValue As Boolean = False
    
    ' Ensure a search string has been specified.
    If text.Length > 0 Then
        ' Obtain the location of the search string in richTextBox1.
        Dim indexToText As Integer = richTextBox1.Find(text, RichTextBoxFinds.MatchCase)
        ' Determine if the text was found in richTextBox1.
        If indexToText >= 0 Then
            returnValue = True
        End If
    End If
    
    Return returnValue
End Function

Hinweise

Die Find -Methode sucht nach dem im str -Parameter angegebenen Text und gibt die Position des ersten Zeichens im Steuerelement zurück. Wenn die -Eigenschaft einen negativen Wert zurückgibt, wurde die gesuchte Textzeichenfolge nicht im Inhalt des Steuerelements gefunden. Mit dieser Methode können Sie Suchfunktionen erstellen, die dem Benutzer des Steuerelements zur Verfügung gestellt werden können. Sie können diese Methode auch verwenden, um nach Text zu suchen, der durch ein bestimmtes Format ersetzt werden soll. Wenn der Benutzer beispielsweise Datumsangaben in das Steuerelement eingegeben hat, können Sie die Find -Methode verwenden, um nach allen Datumsangaben im Dokument zu suchen und sie durch das entsprechende Format zu ersetzen, bevor Sie die SaveFile -Methode des Steuerelements verwenden.

Mit dieser Version der Find Methode können Sie Optionen angeben, mit denen Sie Ihre Suche erweitern oder einschränken können. Sie können Optionen angeben, mit denen Sie die Groß- und Kleinschreibung des Suchworts abgleichen oder nach ganzen Wörtern anstelle von Teilwörtern suchen können. Wenn Sie die RichTextBoxFinds.Reverse Enumeration im options Parameter angeben, können Sie nach Text vom unteren Rand des Dokuments nach oben suchen, anstatt nach der Standardmäßigen Suchmethode von oben nach unten.

Hinweis

Die Find Methoden, die einen string als Parameter akzeptieren, können keinen Text finden, der in mehr als einer Textzeile in der RichTextBoxenthalten ist. Wenn Sie eine solche Suche ausführen, wird der Wert negativ (-1) zurückgegeben.

Gilt für:

Find(Char[], Int32, Int32)

Durchsucht einen Textbereich in einem RichTextBox-Steuerelement nach der ersten Instanz eines Zeichens aus einer Liste von Zeichen.

public:
 int Find(cli::array <char> ^ characterSet, int start, int end);
public int Find (char[] characterSet, int start, int end);
member this.Find : char[] * int * int -> int
Public Function Find (characterSet As Char(), start As Integer, end As Integer) As Integer

Parameter

characterSet
Char[]

Das zu suchende Array von Zeichen.

start
Int32

Die Position im Text des Steuerelements, an der die Suche begonnen werden soll.

end
Int32

Die Position im Text des Steuerelements, an der die Suche beendet werden soll.

Gibt zurück

Die Position im Steuerelement, an der die zu suchenden Zeichen gefunden wurden.

Ausnahmen

characterSet ist NULL.

start ist kleiner als 0 (null) oder größer als die Länge des Texts im Steuerelement.

Hinweise

Diese Version der Find Methode sucht nach dem ersten instance eines Zeichens aus einer Liste von Zeichen, die characterSet im Parameter angegeben sind, und gibt den Speicherort des Zeichens zurück. Beispielsweise übergeben Sie ein Array von Zeichen, das das Zeichen "Q" enthält. Wenn das Steuerelement den Text "The Quick Brown Fox" enthält, würde die Find Methode den Wert vier zurückgeben. Ein Großbuchstaben und ein Kleinbuchstaben werden in der Suche als unterschiedliche Werte betrachtet.

Wenn die -Eigenschaft einen negativen Wert zurückgibt, wurden die gesuchten Zeichen im Inhalt des Steuerelements nicht gefunden. Sie können diese Methode verwenden, um im Steuerelement nach einer Gruppe von Zeichen zu suchen. Wenn ein Zeichen aus der Zeichenliste gefunden wird, die im Parameter der Methode characterSet angegeben wird, ist der von dieser Methode zurückgegebene Wert ein nullbasierter Index der Position des Zeichens im Steuerelement. Ein Leerzeichen wird von der -Methode als Zeichen betrachtet, wenn die Position eines Zeichens bestimmt wird.

Mit dieser Version der Find -Methode können Sie nach einem Zeichensatz aus einem Textbereich im Steuerelement suchen, indem Sie einen Wert für die start Parameter und end angeben. Der Wert 0 für den start Parameter gibt an, dass die Suche am Anfang des Dokuments des Steuerelements beginnen soll. Ein -1-Wert für den end Parameter gibt an, dass die Suche am Ende des Texts im Steuerelement enden soll. Sie können diese Version der Find -Methode verwenden, um Ihre Suche auf einen bestimmten Textbereich innerhalb des Steuerelements einzugrenzen, um zu vermeiden, dass Bereiche des Dokuments gesucht werden, die für die Anforderungen Ihrer Anwendung nicht wichtig sind.

Gilt für:

Find(String, Int32, RichTextBoxFinds)

Durchsucht den Text in einem RichTextBox-Steuerelement nach einer Zeichenfolge an einer bestimmten Position im Steuerelement und mit spezifischen Suchoptionen.

public:
 int Find(System::String ^ str, int start, System::Windows::Forms::RichTextBoxFinds options);
public int Find (string str, int start, System.Windows.Forms.RichTextBoxFinds options);
member this.Find : string * int * System.Windows.Forms.RichTextBoxFinds -> int
Public Function Find (str As String, start As Integer, options As RichTextBoxFinds) As Integer

Parameter

str
String

Der im Steuerelement zu suchende Text.

start
Int32

Die Position im Text des Steuerelements, an der die Suche begonnen werden soll.

options
RichTextBoxFinds

Eine bitweise Kombination der RichTextBoxFinds-Werte.

Gibt zurück

Die Position im Steuerelement, an der der Suchtext gefunden wurde.

Beispiele

Im folgenden Codebeispiel wird der gesamte Inhalt einer RichTextBox nach dem ersten instance einer Suchzeichenfolge durchsucht, die an den text-Parameter der -Methode übergeben wird. Der Startort der Suche wird durch den start-Parameter der -Methode angegeben. Wenn die Suchzeichenfolge in RichTextBoxgefunden wird, gibt die Methode die Indexposition des ersten Zeichens des gefundenen Texts zurück und hebt den gefundenen Text hervor. Andernfalls gibt sie den Wert -1 zurück. Das Beispiel gibt auch Optionen in der Suche an, die der Groß-/Kleinschreibung der angegebenen Suchzeichenfolge entsprechen. Das Beispiel erfordert, dass diese Methode in der Klasse eines Form platziert wird, das einen RichTextBox namens richTextBox1enthält. Sie können dieses Beispiel verwenden, um den Vorgangstyp "Weiter suchen" auszuführen. Sobald eine instance des Suchtexts gefunden wurde, können Sie andere Instanzen des Texts finden, indem Sie den Wert des start Parameters ändern, um an einer Position zu suchen, die über die Position der aktuellen Übereinstimmung hinausgeht.

public:
   int FindMyText( String^ text, int start )
   {
      // Initialize the return value to false by default.
      int returnValue = -1;
      
      // Ensure that a search string has been specified and a valid start point.
      if ( text->Length > 0 && start >= 0 )
      {
         // Obtain the location of the search string in richTextBox1.
         int indexToText = richTextBox1->Find( text, start, RichTextBoxFinds::MatchCase );
         // Determine whether the text was found in richTextBox1.
         if ( indexToText >= 0 )
         {
            returnValue = indexToText;
         }
      }

      return returnValue;
   }
public int FindMyText(string text, int start)
{
   // Initialize the return value to false by default.
   int returnValue = -1;

   // Ensure that a search string has been specified and a valid start point.
   if (text.Length > 0 && start >= 0) 
   {
      // Obtain the location of the search string in richTextBox1.
      int indexToText = richTextBox1.Find(text, start, RichTextBoxFinds.MatchCase);
      // Determine whether the text was found in richTextBox1.
      if(indexToText >= 0)
      {
         returnValue = indexToText;
      }
   }

   return returnValue;
}
Public Function FindMyText(text As String, start As Integer) As Integer
    ' Initialize the return value to false by default.
    Dim returnValue As Integer = - 1
    
    ' Ensure that a search string has been specified and a valid start point.
    If text.Length > 0 And start >= 0 Then
        ' Obtain the location of the search string in richTextBox1.
        Dim indexToText As Integer = richTextBox1.Find(text, start, _
            RichTextBoxFinds.MatchCase)
        ' Determine whether the text was found in richTextBox1.
        If indexToText >= 0 Then
            returnValue = indexToText
        End If
    End If
    
    Return returnValue
End Function

Hinweise

Die Find -Methode sucht nach dem im str -Parameter angegebenen Text und gibt die Position des ersten Zeichens der Suchzeichenfolge innerhalb des Steuerelements zurück. Wenn die -Eigenschaft einen negativen Wert zurückgibt, wurde die gesuchte Textzeichenfolge nicht im Inhalt des Steuerelements gefunden. Sie können diese Methode verwenden, um Suchfunktionen zu erstellen, die dem Benutzer des Steuerelements zur Verfügung gestellt werden können. Sie können diese Methode auch verwenden, um nach Text zu suchen, der durch ein bestimmtes Format ersetzt werden soll. Wenn der Benutzer z. B. Datumsangaben in das Steuerelement eingegeben hat, können Sie die Find -Methode verwenden, um nach allen Datumsangaben im Dokument zu suchen und sie durch das entsprechende Format zu ersetzen, bevor Sie die SaveFile -Methode des Steuerelements verwenden.

Mit dieser Version der Find -Methode können Sie Optionen angeben, mit denen Sie Ihre Suche erweitern oder einschränken können. Sie können Optionen angeben, mit denen Sie die Groß-/Kleinschreibung des Suchworts abgleichen oder nach ganzen Wörtern anstelle von Teilwörtern suchen können. Indem Sie die RichTextBoxFinds.Reverse Enumeration im options Parameter angeben, können Sie nach Text vom unteren Rand des Dokuments nach oben suchen, anstatt nach der standardmäßigen Suchmethode von oben nach unten. Mit dieser Version der Find -Methode können Sie auch die Suche nach Text einschränken, indem Sie eine bestimmte Anfangsposition im Text des Steuerelements auswählen. Mit diesem Feature können Sie Text vermeiden, der möglicherweise bereits durchsucht wurde oder in dem der gesuchte text, bekannt ist, dass er nicht vorhanden ist. Wenn der RichTextBoxFinds.Reverse Wert im options Parameter angegeben ist, gibt der Wert des Parameters die Position an, an der start die umgekehrte Suche endet, da die Suche bei Verwendung dieser Version der Find -Methode am Unteren Rand des Dokuments beginnt.

Hinweis

Die Find Methoden, die einen string als Parameter akzeptieren, können keinen Text finden, der in mehr als einer Textzeile innerhalb des RichTextBoxenthalten ist. Wenn Sie eine solche Suche ausführen, wird der Wert 1 negativ (-1) zurückgegeben.

Gilt für:

Find(String, Int32, Int32, RichTextBoxFinds)

Durchsucht den Text in einem RichTextBox-Steuerelement nach einer Zeichenfolge innerhalb eines bestimmten Textbereichs im Steuerelement und mit spezifischen Suchoptionen.

public:
 int Find(System::String ^ str, int start, int end, System::Windows::Forms::RichTextBoxFinds options);
public int Find (string str, int start, int end, System.Windows.Forms.RichTextBoxFinds options);
member this.Find : string * int * int * System.Windows.Forms.RichTextBoxFinds -> int
Public Function Find (str As String, start As Integer, end As Integer, options As RichTextBoxFinds) As Integer

Parameter

str
String

Der im Steuerelement zu suchende Text.

start
Int32

Die Position im Text des Steuerelements, an der die Suche begonnen werden soll.

end
Int32

Die Position im Text des Steuerelements, an der die Suche beendet werden soll. Dieser Wert muss -1 oder größer oder gleich dem start-Parameter sein.

options
RichTextBoxFinds

Eine bitweise Kombination der RichTextBoxFinds-Werte.

Gibt zurück

Die Position im Steuerelement, an der der Suchtext gefunden wurde.

Ausnahmen

Der str-Parameter war null.

Der start-Parameter war kleiner als 0 (null).

- oder -

Der end-Parameter war kleiner als der start-Parameter.

Beispiele

Im folgenden Codebeispiel wird ein Textabschnitt in einem RichTextBox nach dem ersten instance einer Suchzeichenfolge durchsucht, die an den searchText Parameter der -Methode übergeben wird. Der Bereich, der innerhalb des Steuerelements nach Text gesucht werden soll, wird durch die searchStart Parameter und searchEnd der -Methode angegeben. Wenn die Suchzeichenfolge in RichTextBoxgefunden wird, gibt die Methode die Indexposition des ersten Zeichens des gefundenen Texts zurück und hebt den gefundenen Text hervor. Andernfalls gibt sie den Wert -1 zurück. Im Beispiel wird auch der options Parameter der Find -Methode verwendet, um anzugeben, dass der gefundene Text mit der Groß-/Kleinschreibung der Suchzeichenfolge übereinstimmen soll. Das Beispiel erfordert, dass diese Methode in der -Klasse eines Form platziert wird, das ein RichTextBox Steuerelement mit dem Namen richTextBox1enthält. Nachdem die erste instance der Suchzeichenfolge gefunden wurde, können Sie dieses Beispiel verwenden, um andere Instanzen im Text zu finden.

public:
   int FindMyText( String^ searchText, int searchStart, int searchEnd )
   {
      // Initialize the return value to false by default.
      int returnValue = -1;

      // Ensure that a search string and a valid starting point are specified.
      if ( searchText->Length > 0 && searchStart >= 0 )
      {
         // Ensure that a valid ending value is provided.
         if ( searchEnd > searchStart || searchEnd == -1 )
         {
            // Obtain the location of the search string in richTextBox1.
            int indexToText = richTextBox1->Find( searchText, searchStart, searchEnd, RichTextBoxFinds::MatchCase );

            // Determine whether the text was found in richTextBox1.
            if ( indexToText >= 0 )
            {
               // Return the index to the specified search text.
               returnValue = indexToText;
            }
         }
      }

      return returnValue;
   }
public int FindMyText(string searchText, int searchStart, int searchEnd)
{
    // Initialize the return value to false by default.
    int returnValue = -1;

    // Ensure that a search string and a valid starting point are specified.
    if (searchText.Length > 0 && searchStart >= 0) 
    {
        // Ensure that a valid ending value is provided.
        if (searchEnd > searchStart || searchEnd == -1)
        {	
            // Obtain the location of the search string in richTextBox1.
            int indexToText = richTextBox1.Find(searchText, searchStart, searchEnd, RichTextBoxFinds.MatchCase);
            // Determine whether the text was found in richTextBox1.
            if(indexToText >= 0)
            {
                // Return the index to the specified search text.
                returnValue = indexToText;
            }
        }
    }

    return returnValue;
}
Public Function FindMyText(ByVal searchText As String, ByVal searchStart As Integer, ByVal searchEnd As Integer) As Integer
    ' Initialize the return value to false by default.
    Dim returnValue As Integer = -1

    ' Ensure that a search string and a valid starting point are specified.
    If searchText.Length > 0 And searchStart >= 0 Then
        ' Ensure that a valid ending value is provided.
        If searchEnd > searchStart Or searchEnd = -1 Then
            ' Obtain the location of the search string in richTextBox1.
        Dim indexToText As Integer = richTextBox1.Find(searchText, searchStart, searchEnd, RichTextBoxFinds.MatchCase)
            ' Determine whether the text was found in richTextBox1.
            If indexToText >= 0 Then
                ' Return the index to the specified search text.
                returnValue = indexToText
            End If
        End If
    End If

    Return returnValue
End Function

Hinweise

Die Find -Methode sucht nach dem im str -Parameter angegebenen Text und gibt die Position des ersten Zeichens der Suchzeichenfolge innerhalb des Steuerelements zurück. Wenn die -Eigenschaft einen negativen Wert zurückgibt, wurde die gesuchte Textzeichenfolge nicht im Inhalt des Steuerelements gefunden. Sie können diese Methode verwenden, um Suchfunktionen zu erstellen, die dem Benutzer des Steuerelements zur Verfügung gestellt werden können. Sie können diese Methode auch verwenden, um nach Text zu suchen, der durch ein bestimmtes Format ersetzt werden soll. Wenn der Benutzer beispielsweise Datumsangaben in das Steuerelement eingegeben hat, können Sie die Find -Methode verwenden, um nach allen Datumsangaben im Dokument zu suchen und sie durch das entsprechende Format zu ersetzen, bevor Sie die SaveFile -Methode des Steuerelements verwenden.

Mit dieser Version der Find -Methode können Sie Optionen angeben, mit denen Sie Ihre Suche erweitern oder einschränken können. Sie können Optionen angeben, mit denen Sie die Groß-/Kleinschreibung des Suchworts abgleichen oder nach ganzen Wörtern anstelle von Teilwörtern suchen können. Indem Sie die RichTextBoxFinds.Reverse Enumeration im options Parameter angeben, können Sie nach Text vom unteren Rand des Dokuments nach oben suchen, anstatt nach der standardmäßigen Suchmethode von oben nach unten. Mit dieser Version der Find -Methode können Sie auch die Suche nach Text einschränken, indem Sie eine bestimmte Anfangs- und Endposition im Text des Steuerelements auswählen. Mit diesem Feature können Sie den Suchbereich auf einen bestimmten Abschnitt des Steuerelementtexts beschränken. Wenn dem end Parameter ein negativer Wert (-1) zugewiesen wird, sucht die Methode bis zum Ende des Texts im RichTextBox nach normalen Suchvorgängen. Bei umgekehrten Suchvorgängen gibt der dem Parameter zugewiesene end negative Wert (-1) an, dass Text vom Ende des Texts (unten) bis zur durch den Parameter definierten start Position durchsucht wird. Wenn die start Parameter und end derselbe Wert bereitgestellt werden, wird das gesamte Steuerelement nach normalen Suchvorgängen durchsucht. Bei einer umgekehrten Suche wird das gesamte Steuerelement durchsucht, aber die Suche beginnt am unteren Rand des Dokuments und sucht am Anfang des Dokuments.

Hinweis

Die Find Methoden, die einen string als Parameter akzeptieren, können keinen Text finden, der in mehr als einer Textzeile innerhalb des RichTextBoxenthalten ist. Wenn Sie eine solche Suche ausführen, wird der Wert 1 negativ (-1) zurückgegeben.

Gilt für: