ListItemCollection.FindByValue-Methode

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

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

Syntax

'Declaration
Public Function FindByValue ( _
    value As String _
) As ListItem
'Usage
Dim instance As ListItemCollection
Dim value As String
Dim returnValue As ListItem

returnValue = instance.FindByValue(value)

public ListItem FindByValue (
    string value
)

public:
ListItem^ FindByValue (
    String^ value
)

public ListItem FindByValue (
    String value
)

public function FindByValue (
    value : String
) : ListItem

Parameter

• value
  Der zu suchende Wert.

Rückgabewert

Ein ListItem, das den vom value-Parameter angegebenen Wert enthält.

Hinweise

Verwenden Sie die FindByValue-Methode, um in der Auflistung nach einem ListItem mit einer Value-Eigenschaft zu suchen, die den vom value-Parameter angegebenen Wert 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
FindByText
ListItem-Klasse
ListItem.Value-Eigenschaft