Diese Dokumentation wurde archiviert und wird nicht länger gepflegt.

ListView.FindItemWithText-Methode (String)

Aktualisiert: November 2007

Sucht das erste ListViewItem, das mit dem angegebenen Textwert beginnt.

Namespace:  System.Windows.Forms
Assembly:  System.Windows.Forms (in System.Windows.Forms.dll)

public ListViewItem FindItemWithText(
	string text
)
public ListViewItem FindItemWithText(
	String text
)
public function FindItemWithText(
	text : String
) : ListViewItem

Parameter

text
Typ: System.String
Der zu suchende Text.

Rückgabewert

Typ: System.Windows.Forms.ListViewItem
Das erste ListViewItem, das mit dem angegebenen Textwert beginnt.

Bei der Suche wird die Groß- und Kleinschreibung nicht berücksichtigt.

Der text-Parameter kann eine Teilzeichenfolge des gewünschten übereinstimmenden Texts angeben. Zudem gibt diese Methode das erste Element zurück, das mit dem angegebenen Text beginnt. Wenn eine ListView beispielsweise zwei Listenelemente enthält, wobei der Text des ersten Elements auf "angle bracket" und der Text des zweiten Elements auf "bracket" festgelegt ist, gibt ein Aufruf von FindItemWithText, der brack als Parameter übergibt, das Element mit dem Text "bracket" zurück.

Die FindItemWithText-Methode gibt null zurück, wenn die Liste leer ist oder kein entsprechendes Element vorhanden ist.

Im folgenden Codebeispiel wird die FindItemWithText-Methode veranschaulicht. Fügen Sie zum Ausführen dieses Beispiels den folgenden Code in ein Windows Form ein, und rufen Sie die InitializeFindListView-Methode im Konstruktor oder im Load-Ereignishandler des Formulars auf. Klicken Sie auf die Schaltfläche, um die Ergebnisse des Methodenaufrufs anzuzeigen.

		// Declare the ListView and Button for the example.
        ListView findListView = new ListView();
        Button findButton = new Button();

        private void InitializeFindListView()
        {
	    // Set up the location and event handling for the button.
            findButton.Click += new EventHandler(findButton_Click);
            findButton.Location = new Point(10, 10);
			
	    // Set up the location of the ListView and add some items.
	    findListView.Location = new Point(10, 30);
            findListView.Items.Add(new ListViewItem("angle bracket"));
            findListView.Items.Add(new ListViewItem("bracket holder"));
            findListView.Items.Add(new ListViewItem("bracket"));

            // Add the button and ListView to the form.
            this.Controls.Add(findButton);
            this.Controls.Add(findListView);
        }

		void findButton_Click(object sender, EventArgs e)
		{
	            // Call FindItemWithText, sending output to MessageBox.
		    ListViewItem item1 = findListView.FindItemWithText("brack");
			 if (item1 != null)
				 MessageBox.Show("Calling FindItemWithText passing 'brack': " 
                     + item1.ToString());
			 else
				 MessageBox.Show("Calling FindItemWithText passing 'brack': null");
		 }


Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

.NET Framework und .NET Compact Framework unterstützen nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.

.NET Framework

Unterstützt in: 3.5, 3.0, 2.0
Anzeigen: