String.Trim Метод

Определение

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

Перегрузки

Trim(Char)

Удаляет все начальные и конечные экземпляры символа из текущей строки.

Trim(ReadOnlySpan<Char>)

Удаляет все начальные и конечные вхождения набора символов, указанных в диапазоне из текущей строки.

Trim()

Удаляет все начальные и конечные пробелы из текущей строки.

Trim(Char[])

Удаляет все начальные и конечные вхождения набора символов, указанных в массиве из текущей строки.

Trim(Char)

Исходный код:
String.Manipulation.cs
Исходный код:
String.Manipulation.cs
Исходный код:
String.Manipulation.cs

Удаляет все начальные и конечные экземпляры символа из текущей строки.

public string Trim (char trimChar);

Параметры

trimChar
Char

Символ Юникода для удаления.

Возвращаемое значение

Строка, которая остается после всех экземпляров символа trimChar, удаляется из начала и конца текущей строки. Если символы не могут быть обрезаны из текущего экземпляра, метод возвращает текущий экземпляр без изменений.

Комментарии

Метод Trim(System.Char) удаляет из текущей строки все начальные и конечные экземпляры символа trimChar. Каждая начальная и конечная операция обрезки останавливается при обнаружении символа, отличного от trimChar. Например, если trimChar-, а текущая строка — "---abc---xyz----", метод Trim(System.Char) возвращает "abc---xyz". Чтобы удалить символы между словами в строке, используйте регулярные выражения .NET.

Ескерім

Если метод Trim(System.Char) удаляет любые символы из текущего экземпляра, этот метод не изменяет значение текущего экземпляра. Вместо этого возвращается новая строка, в которой удаляются все начальные и конечные trimChar символы, найденные в текущем экземпляре.

Если текущая строка равна Empty или все символы в текущем экземпляре состоят из trimChar символов, метод возвращает Empty.

Применяется к

.NET 9 және басқа нұсқалар
Өнім Нұсқалар
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Standard 2.1

Trim(ReadOnlySpan<Char>)

Удаляет все начальные и конечные вхождения набора символов, указанных в диапазоне из текущей строки.

public string Trim (scoped ReadOnlySpan<char> trimChars);

Параметры

trimChars
ReadOnlySpan<Char>

Диапазон символов Юникода для удаления.

Возвращаемое значение

Строка, которая остается после всех вхождения символов в параметре trimChars, удаляется из начала и конца текущей строки. Если trimChars пуст, вместо этого удаляются символы пробелов. Если символы не могут быть обрезаны из текущего экземпляра, метод возвращает текущий экземпляр без изменений.

Применяется к

.NET 9
Өнім Нұсқалар
.NET 9

Trim()

Исходный код:
String.Manipulation.cs
Исходный код:
String.Manipulation.cs
Исходный код:
String.Manipulation.cs

Удаляет все начальные и конечные пробелы из текущей строки.

public string Trim ();

Возвращаемое значение

Строка, которая остается после всех символов пробелов, удаляется из начала и конца текущей строки. Если символы не могут быть обрезаны из текущего экземпляра, метод возвращает текущий экземпляр без изменений.

Примеры

В следующем примере метод String.Trim() используется для удаления дополнительного пробела из строк, введенных пользователем перед объединением.

using System;

public class Example
{
    public static void Main()
    {
        Console.Write("Enter your first name: ");
        string firstName = Console.ReadLine();
      
        Console.Write("Enter your middle name or initial: ");
        string middleName = Console.ReadLine();
      
        Console.Write("Enter your last name: ");
        string lastName = Console.ReadLine();
      
        Console.WriteLine();
        Console.WriteLine("You entered '{0}', '{1}', and '{2}'.", 
                        firstName, middleName, lastName);
      
        string name = ((firstName.Trim() + " " + middleName.Trim()).Trim() + " " + 
                    lastName.Trim()).Trim();
        Console.WriteLine("The result is " + name + ".");

        // The following is a possible output from this example:
        //       Enter your first name:    John
        //       Enter your middle name or initial:
        //       Enter your last name:    Doe
        //       
        //       You entered '   John  ', '', and '   Doe'.
        //       The result is John Doe.
    }
}

Комментарии

Метод Trim удаляет из текущей строки все начальные и конечные символы пробелов. Каждая начальная и конечная операция обрезки останавливается при обнаружении символа, отличного от пробела. Например, если текущая строка — abc xyz, метод Trim возвращает значение abc xyz. Чтобы удалить пробелы между словами в строке, используйте регулярные выражения .NET.

Ескерім

Если метод Trim удаляет любые символы из текущего экземпляра, этот метод не изменяет значение текущего экземпляра. Вместо этого возвращается новая строка, в которой удаляются все начальные и конечные символы пробелов, найденные в текущем экземпляре.

Если текущая строка равна Empty или все символы в текущем экземпляре состоят из символов пробелов, метод возвращает Empty.

Пробелы определяются стандартом Юникода. Метод Trim удаляет все начальные и конечные символы, которые создают возвращаемое значение true при передаче в метод Char.IsWhiteSpace.

Примечания для тех, кто вызывает этот метод

.NET Framework 3.5 с пакетом обновления 1 (SP1) и более ранних версий поддерживает внутренний список символов пробелов, которые этот метод обрезает. Начиная с .NET Framework 4 метод обрезает все символы пробелов Юникода (т. е. символы, которые создают значение true возвращаемого значения при передаче в метод IsWhiteSpace(Char)). Из-за этого изменения метод Trim() в .NET Framework 3.5 с пакетом обновления 1 (SP1) и более ранних версиях удаляет два символа, НОЛЬ ШИРИНЫ (U+200B) и НУЛЕВОЙ ШИРИНЫ NO-BREAK ПРОБЕЛ (U+FEFF), что метод Trim() в .NET Framework 4 и более поздних версиях не удаляется. Кроме того, метод Trim() в .NET Framework 3.5 с пакетом обновления 1 (SP1) и более ранних версиях не обрезает три символа пробела Юникода: РАЗДЕЛИТЕЛЬ VOWEL (U+180E), СУЗИТЬ NO-BREAK ПРОБЕЛ (U+202F) и СРЕДНИЙ МАТЕМАТИЧЕСКИЙ ПРОБЕЛ (U+205F).

См. также раздел

Применяется к

.NET 9 және басқа нұсқалар
Өнім Нұсқалар
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

Trim(Char[])

Исходный код:
String.Manipulation.cs
Исходный код:
String.Manipulation.cs
Исходный код:
String.Manipulation.cs

Удаляет все начальные и конечные вхождения набора символов, указанных в массиве из текущей строки.

public string Trim (params char[] trimChars);
public string Trim (params char[]? trimChars);

Параметры

trimChars
Char[]

Массив символов Юникода для удаления или null.

Возвращаемое значение

Строка, которая остается после всех вхождения символов в параметре trimChars, удаляется из начала и конца текущей строки. Если trimCharsnull или пустой массив, вместо этого удаляются символы пробела. Если символы не могут быть обрезаны из текущего экземпляра, метод возвращает текущий экземпляр без изменений.

Примеры

В следующем примере метод Trim(System.Char[]) используется для удаления пространства, звездочки (*) и апострофа (') из строки.

char[] charsToTrim = { '*', ' ', '\''};
string banner = "*** Much Ado About Nothing ***";
string result = banner.Trim(charsToTrim);
Console.WriteLine("Trimmed\n   {0}\nto\n   '{1}'", banner, result);

// The example displays the following output:
//       Trimmed
//          *** Much Ado About Nothing ***
//       to
//          'Much Ado About Nothing'

Комментарии

Метод Trim(System.Char[]) удаляет из текущей строки все начальные и конечные символы, находящиеся в параметре trimChars. Каждая начальная и конечная операция обрезки останавливается при обнаружении символа, который не находится в trimChars. Например, если текущая строка имеет значение "123abc456xyz789" и trimChars содержит цифры от "1" до "9", метод Trim(System.Char[]) возвращает "abc456xyz".

Ескерім

Если метод Trim(System.Char[]) удаляет любые символы из текущего экземпляра, этот метод не изменяет значение текущего экземпляра. Вместо этого возвращается новая строка, в которой удаляются все начальные и конечные trimChars символы, найденные в текущем экземпляре.

Если текущая строка равна Empty или все символы в текущем экземпляре состоят из символов в массиве trimChars, метод возвращает Empty.

Если trimCharsnull или пустой массив, этот метод удаляет все начальные или конечные символы, которые приводят к возврату метода true при передаче в метод Char.IsWhiteSpace.

Примечания для тех, кто вызывает этот метод

Платформа .NET Framework 3.5 с пакетом обновления 1 (SP1) и более ранние версии поддерживает внутренний список символов пробелов, которые этот метод обрезает, если trimCharsnull или пустой массив. Начиная с .NET Framework 4, если trimCharsnull или пустой массив, метод обрезает все символы пробелов Юникода (то есть символы, которые создают true возвращаемое значение при передаче в метод IsWhiteSpace(Char)). Из-за этого изменения метод Trim() в .NET Framework 3.5 с пакетом обновления 1 (SP1) и более ранних версиях удаляет два символа, НОЛЬ ШИРИНЫ (U+200B) и НУЛЕВОЙ ШИРИНЫ NO-BREAK ПРОБЕЛ (U+FEFF), что метод Trim() в .NET Framework 4and более поздних версий не удаляется. Кроме того, метод Trim() в .NET Framework 3.5 с пакетом обновления 1 (SP1) и более ранних версиях не обрезает три символа пробела Юникода: РАЗДЕЛИТЕЛЬ VOWEL (U+180E), СУЗИТЬ NO-BREAK ПРОБЕЛ (U+202F) и СРЕДНИЙ МАТЕМАТИЧЕСКИЙ ПРОБЕЛ (U+205F).

См. также раздел

Применяется к

.NET 9 және басқа нұсқалар
Өнім Нұсқалар
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0