Функция Left (Visual Basic)

Статья
11/05/2008

Обновлен: Ноябрь 2007

Возвращает строку, содержащую указанное число знаков с левой стороны строки.

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.

Примечание.
Функция LeftB в более ранних версиях Visual Basic возвращает строку в байтах вместо знаков. В основном она применяется для преобразования строк в приложениях с двухбайтовым набором знаков (DBCS). Все строки текущей версии Visual Basic кодируются в Юникоде, и функция LeftB не поддерживается.

Функция LeftB в более ранних версиях Visual Basic возвращает строку в байтах вместо знаков. В основном она применяется для преобразования строк в приложениях с двухбайтовым набором знаков (DBCS). Все строки текущей версии Visual Basic кодируются в Юникоде, и функция 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 (библиотека времени выполнения, в Microsoft.VisualBasic.dll)

См. также

Основные понятия

Сводка изменений поддержки элементов программирования

Ссылки

Сводка по работе со строками

Функция Right (Visual Basic)

Функция Len (Visual Basic)

Функция Mid (Visual Basic)

ArgumentException

Поделиться через