Left 函数 (Visual Basic)

更新：2007 年 11 月

返回一个字符串，其中包含从某个字符串左侧开始的指定数量的字符。

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

参数

str
必选。String 表达式，从该表达式返回最左端的字符。
Length
必选。Integer 表达式。指示要返回的字符数的数值表达式。如果为 0，则返回零长度字符串 ("")。如果其值大于或等于 str 中的字符数，则返回整个字符串。

异常类型	错误号	条件
ArgumentException	5	Length < 0.

如果正在升级使用非结构化错误处理方式的 Visual Basic 6.0 应用程序，请参见“错误号”一列。（您可以根据 Number 属性（Err 对象）比较错误号。）然而，如果可能，应当考虑用 Visual Basic 的结构化异常处理概述替换这种错误控制。

若要确定 str 中的字符数，请使用 Len 函数。如果要在 Windows 窗体应用程序或任何其他具有 Left 属性的类中使用，则必须以 Microsoft.VisualBasic.Left 完全限定该函数。

说明：
Visual Basic 早期版本中的 LeftB 函数返回字节形式（而不是字符形式）的字符串。它主要用于在双字节字符集 (DBCS) 应用程序中转换字符串。当前所有 Visual Basic 字符串均采用 Unicode 的形式，不再支持 LeftB。

此示例演示返回给定 String 的子字符串的 Left 函数的用法。在具有 Left 属性的类中，可能需要对 Left 函数进行完全限定。

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

**模块：**Strings

**程序集：**Visual Basic 运行库（在 Microsoft.VisualBasic.dll 中）