共用方式為


Left 函式 (Visual Basic)

更新:2007 年 11 月

傳回包含來自於某一字串左邊指定數量字元的字串。

Public Shared Function Left( _
   ByVal str As String, _
   ByVal Length As Integer _
) As String

參數

  • str
    必要項。String 運算式,會從其中傳回最左邊的字元。

  • Length
    必要項。Integer 運算式。指示要傳回多少字元的數值運算式。如果此引數為零,則會傳回長度為零的字串 ("")。如果此引數大於或等於 str 中的字元數量,則會傳回完整的字串。

例外狀況

例外狀況類型

錯誤代碼

條件

ArgumentException

5

Length < 0.

如果將使用非結構化錯誤處理的 Visual Basic 6.0 應用程式升級,請參閱「錯誤代碼」資料行 (您可以將錯誤代碼與 Number 屬性 (Err 物件) 比對)。但是,請盡可能考慮以 Visual Basic 的結構化例外處理概觀 取代這類錯誤控制項。

備註

若要判斷 str 中的字元數,請使用 Len 函式。如果使用於 Windows Forms 應用程式中,或具有 Left 屬性的其他任何類別,則必須以完整名稱描述含 Microsoft.VisualBasic.Left 的函式。

注意事項:

在舊版 Visual Basic 中,LeftB 函式會以位元組為單位傳回字串,而不是字元。這項功能主要用來轉換雙位元組字元集 (DBCS) 應用程式中的字串。目前所有的 Visual Basic 字串都是 Unicode,而且不再支援 LeftB。

範例

這個範例會示範使用 Left 函式,以傳回指定 String 的子字串。在具有 Left 屬性的類別中,可能必須完整限定 Left 函式。

Dim TestString As String = "Hello World!"
' Returns "Hello".
Dim subString As String = Microsoft.VisualBasic.Left(TestString, 5)

需求

命名空間Microsoft.VisualBasic

模組:Strings

組件:Visual Basic Runtime Library (在 Microsoft.VisualBasic.dll 中)

請參閱

概念

程式設計項目的支援變更摘要

參考

字串操作摘要

Right 函式 (Visual Basic)

Len 函式 (Visual Basic)

Mid 函式 (Visual Basic)

ArgumentException