Strings.Left(String, Int32) Metoda

Definicja

Przestrzeń nazw:

Microsoft.VisualBasic

Zestaw:

Microsoft.VisualBasic.Core.dll

Źródło:

Strings.vb

Zwraca ciąg zawierający określoną liczbę znaków po lewej stronie ciągu.

public:
 static System::String ^ Left(System::String ^ str, int Length);

public static string Left (string? str, int Length);

static member Left : string * int -> string

Public Function Left (str As String, Length As Integer) As String

Parametry

str

String

Wymagane. String wyrażenie, z którego są zwracane najbardziej lewe znaki.

Length

Int32

Wymagane. Integer Wyrażenie. Wyrażenie liczbowe wskazujące liczbę znaków do zwrócenia. W przypadku wartości 0 zwracany jest ciąg o zerowej długości (""). Jeśli liczba znaków w obiekcie strjest większa lub równa liczbie znaków , zwracany jest cały ciąg.

Zwraca

String

Ciąg zawierający określoną liczbę znaków z lewej strony ciągu.

Wyjątki

ArgumentException

Length< 0.

Przykłady

W tym przykładzie pokazano użycie Left funkcji w celu zwrócenia podciągów danego Stringelementu . W klasie, która ma Left właściwość, może być konieczne, aby w pełni zakwalifikować Left funkcję.

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

Uwagi

Aby określić liczbę znaków w strpliku , użyj Len funkcji . W przypadku użycia w aplikacji Windows Forms lub dowolnej innej klasie, która ma Left właściwość, należy w pełni zakwalifikować funkcję za pomocą Microsoft.VisualBasic.Leftpolecenia .

Uwaga

Funkcja LeftB w poprzednich wersjach języka Visual Basic zwraca ciąg w bajtach, a nie znaki. Służy przede wszystkim do konwersji ciągów w aplikacjach z zestawami dwubajtowych znaków (znaków DBCS). Wszystkie bieżące ciągi języka Visual Basic są w formacie Unicode i LeftB nie są już obsługiwane.

Zobacz też

• Right(String, Int32)
• Len
• Mid
• ArgumentException
• Manipulowanie ciągami — podsumowanie