ListItemCollection.FindByValue メソッド

.NET Framework クラス ライブラリ リファレンス

ListItemCollection.FindByValue メソッド

指定した値を格納している Value プロパティを持つ ListItem をコレクション内で検索します。

名前空間: System.Web.UI.WebControls
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Public Function FindByValue ( _
    value As String _
) As ListItem

Visual Basic (使用法)

Dim instance As ListItemCollection
Dim value As String
Dim returnValue As ListItem

returnValue = instance.FindByValue(value)

C#

public ListItem FindByValue (
    string value
)

C++

public:
ListItem^ FindByValue (
    String^ value
)

J#

public ListItem FindByValue (
    String value
)

JScript

public function FindByValue (
    value : String
) : ListItem

パラメータ

value

検索対象の値。

戻り値
value パラメータで指定した値を格納している ListItem。

解説

FindByValue メソッドを使用して、value パラメータで指定した値を格納している Value プロパティを持つ ListItem をコレクション内で検索します。このメソッドは、大文字と小文字を区別し、カルチャに依存しない比較を実行します。このメソッドは、部分検索またはワイルドカード検索は実行しません。この検索条件を使用して項目がコレクション内で見つからない場合は、null 参照 (Visual Basic では Nothing) が返されます。

使用例

Visual Basic

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
                  

C#

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;

プラットフォーム

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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
ListItemCollection クラス
ListItemCollection メンバ
System.Web.UI.WebControls 名前空間
FindByText
ListItem クラス
ListItem.Value プロパティ