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

  • Статья

Обновлен: Ноябрь 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.

y050k1wb.alert_note(ru-ru,VS.90).gifПримечание.

Функция 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