共用方式為


Strings.InStr 方法 (String, String, CompareMethod)

傳回整數,指定一個字串在另一個字串內第一次出現的起始位置。

命名空間: Microsoft.VisualBasic
組件: Microsoft.VisualBasic (在 microsoft.visualbasic.dll 中)

語法

'宣告
Public Shared Function InStr ( _
    String1 As String, _
    String2 As String, _
    <OptionalAttribute> Optional Compare As CompareMethod = CompareMethod.Binary _
) As Integer
'用途
Dim String1 As String
Dim String2 As String
Dim Compare As CompareMethod
Dim returnValue As Integer

returnValue = Strings.InStr(String1, String2, Compare)
public static int InStr (
    string String1,
    string String2,
    [OptionalAttribute] CompareMethod Compare
)
public:
static int InStr (
    String^ String1, 
    String^ String2, 
    [OptionalAttribute] CompareMethod Compare
)
public static int InStr (
    String String1, 
    String String2, 
    /** @attribute OptionalAttribute() */ CompareMethod Compare
)
public static function InStr (
    String1 : String, 
    String2 : String, 
    Compare : CompareMethod
) : int

參數

  • String1
    必要項。正在搜尋的 String 運算式。
  • String2
    必要項。找到的 String 運算式。
  • Compare
    選擇項。指定字串比較的類型。如果省略了 Compare,則 Option Compare 設定可決定比較的類型。

傳回值

如果 String1 的長度為零或 Nothing,InStr 會傳回 0。如果 String2 的長度為零或 Nothing,InStr 會傳回 Start。如果找不到 String2,InStr 會傳回 0。如果在 String1 中找到了 String2,InStr 會傳回比對開始的位置。如果 Start > String2,InStr 會傳回 0。

備註

如需詳細資訊,請參閱 Visual Basic 的主題 InStr 函式 (Visual Basic)

一般來說,在剖析字串時會使用 InStr 函式。

Note注意事項

Visual Basic 舊版的 InStrB 函式會傳回一些位元組,而非字元位置。這項功能主要用來轉換雙位元組字元集 (DBCS) 應用程式中的字串。所有的 Visual Basic 2005 字串都以 Unicode 編碼,且不再支援 InStrB

Compare 引數設定為:

常數

說明

Binary

0

執行二進位比較

Text

1

執行文字比較

範例

此範例使用 InStr 函式傳回某個字串在另一個字串中第一次出現的位置。

' String to search in.
Dim SearchString As String = "XXpXXpXXPXXP"
' Search for "P".
Dim SearchChar As String = "P"

Dim TestPos As Integer
' A textual comparison starting at position 4. Returns 6.
TestPos = InStr(4, SearchString, SearchChar, CompareMethod.Text)

' A binary comparison starting at position 1. Returns 9.
TestPos = InStr(1, SearchString, SearchChar, CompareMethod.Binary)

' If Option Compare is not set, or set to Binary, return 9.
' If Option Compare is set to Text, returns 3.
TestPos = InStr(SearchString, SearchChar)

' Returns 0.
TestPos = InStr(1, SearchString, "W")

平台

Windows 98、 Windows 2000 SP4、 Windows CE、 Windows Millennium Edition、 Windows Mobile for Pocket PC、 Windows Mobile for Smartphone、 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

.NET Compact Framework

支援版本:2.0、1.0

請參閱

參考

Strings 類別
Strings 成員
Microsoft.VisualBasic 命名空間
ArgumentException

其他資源

InStr 函式 (Visual Basic)
Visual Basic 中的字串
Visual Basic 中的字串簡介
InStrRev 函式 (Visual Basic)
Option Compare 陳述式
StrComp 函式 (Visual Basic)
程式設計項目的支援變更摘要