ListItemCollection.FindByText-Methode

Sucht in der Auflistung nach einem ListItem mit einer Text-Eigenschaft, die den angegebenen Text enthält.

Namespace: System.Web.UI.WebControls
Assembly: System.Web (in system.web.dll)

Syntax

'Declaration
Public Function FindByText ( _
    text As String _
) As ListItem
'Usage
Dim instance As ListItemCollection
Dim text As String
Dim returnValue As ListItem

returnValue = instance.FindByText(text)

public ListItem FindByText (
    string text
)

public:
ListItem^ FindByText (
    String^ text
)

public ListItem FindByText (
    String text
)

public function FindByText (
    text : String
) : ListItem

Parameter

• text
  Der zu suchende Text.

Rückgabewert

Ein ListItem, das den vom text-Parameter angegebenen Text enthält.

Hinweise

Verwenden Sie die FindByText-Methode, um in der Auflistung nach einem ListItem mit einer Text-Eigenschaft zu suchen, die den vom text-Parameter angegebenen Text enthält. Diese Methode führt einen kulturunabhängigen Vergleich unter Berücksichtigung von Groß- und Kleinschreibung durch. Diese Methode führt keine Suchvorgänge nach Wortbestandteilen oder mit Platzhaltern durch. Wenn mit diesen Kriterien kein Element in der Auflistung gefunden wird, wird NULL (Nothing in Visual Basic) zurückgegeben.

Beispiel

Dim myListItem As ListItem = SearchType.SelectedItem
Dim crItem As ListItem 
Dim searchText As String  = TextBox1.Text
If(myListItem.Value = "Name") Then
    If(TextBox1.Text <> "" ) Then        
        Dim searchSubfirst As String = searchText.Substring(0,1)
        Dim searchSubsecond As String = searchText.Substring(1)
        searchText = searchSubfirst.ToUpper()+searchSubsecond.ToLower()
        ' Search by country or region name.                       
        crItem = ItemCollection.FindByText(searchText)    
    End If            
Else
    'Search by country or region code.
    crItem = ItemCollection.FindByValue(searchText.ToUpper())
End If

Dim str As String  = "Search is successful. Match is Found.<br>"
str = str & "The results for search string '" & searchText & "' are:<br>"
str = str & "the country or region code is: " & crItem.Value & "<br>"
str = str & "the country or region name is: " & crItem.Text
' Add the string to the label.
Label1.Text = str
                  

ListItem myListItem = SearchType.SelectedItem;
ListItem crItem = null;
String searchText = TextBox1.Text;
if(myListItem.Value == "Name")
{
    if(TextBox1.Text != "")
    {
        String searchSubfir = searchText.Substring(0,1);
        String searchSubsec = searchText.Substring(1);
        searchText = searchSubfir.ToUpper()+searchSubsec.ToLower();

        // Search by country or region name.
        crItem = ItemCollection.FindByText(searchText);
    }
}
else
{
    // Search by country or region code.
    crItem = ItemCollection.FindByValue(searchText.ToUpper());
}

String str = "Search is successful. Match is Found.<br>";
str =str + "The results for search string '" + searchText + "' are:<br>";
str = str + "the country or region code is " + crItem.Value + "<br>";
str = str + "the country or region name is " + crItem.Text;

// Add the string to the label.
Label1.Text = str;

Plattformen

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

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

ListItemCollection-Klasse
ListItemCollection-Member
System.Web.UI.WebControls-Namespace
FindByValue
ListItem-Klasse
ListItem.Text-Eigenschaft