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)

模組：Strings

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