String.PadLeft Metoda
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Zwraca nowy ciąg o określonej długości, w którym początek bieżącego ciągu jest wypełniony spacjami lub określonym znakiem Unicode.
| PadLeft(Int32, Char) |
Zwraca nowy ciąg, który wyrównuje znaki w tym wystąpieniu, dopełniając je po lewej stronie określonym znakiem Unicode dla określonej całkowitej długości. |
| PadLeft(Int32) |
Zwraca nowy ciąg, który wyrównuje znaki w tym wystąpieniu, dopełniając je spacjami po lewej stronie dla określonej całkowitej długości. |
- Źródło:
- String.Manipulation.cs
- Źródło:
- String.Manipulation.cs
- Źródło:
- String.Manipulation.cs
Zwraca nowy ciąg, który wyrównuje znaki w tym wystąpieniu, dopełniając je po lewej stronie określonym znakiem Unicode dla określonej całkowitej długości.
public:
System::String ^ PadLeft(int totalWidth, char paddingChar);public string PadLeft (int totalWidth, char paddingChar);member this.PadLeft : int * char -> stringPublic Function PadLeft (totalWidth As Integer, paddingChar As Char) As StringParametry
- totalWidth
- Int32
Liczba znaków w ciągu wynikowym, równa liczbie oryginalnych znaków i znaków dodatkowych dopełnienia.
- paddingChar
- Char
Znak dopełnienia Unicode.
Zwraca
Nowy ciąg, który jest odpowiednikiem tego wystąpienia, ale wyrównany do prawej i dopełniony po lewej stronie z dowolną liczbą paddingChar znaków, aby utworzyć długość totalWidth. Jeśli jednak totalWidth jest mniejsza niż długość tego wystąpienia, metoda zwraca odwołanie do istniejącego wystąpienia. Jeśli totalWidth jest równa długości tego wystąpienia, metoda zwraca nowy ciąg, który jest identyczny z tym wystąpieniem.
Wyjątki
Parametr totalWidth ma wartość niższą niż zero.
Przykłady
W poniższym przykładzie pokazano metodę PadLeft .
using namespace System;
void main()
{
String^ str = "forty-two";
Console::WriteLine( str->PadLeft( 15, L'.' ) );
Console::WriteLine( str->PadLeft( 2, L'.' ) );
}
// The example displays the following output:
// ......forty-two
// forty-two
using System;
class Sample
{
public static void Main()
{
string str = "forty-two";
char pad = '.';
Console.WriteLine(str.PadLeft(15, pad));
Console.WriteLine(str.PadLeft(2, pad));
}
}
// The example displays the following output:
// ......forty-two
// forty-two
let str = "forty-two"
let pad = '.'
printfn $"{str.PadLeft(15, pad)}"
printfn $"{str.PadLeft(2, pad)}"
// The example displays the following output:
// ......forty-two
// forty-two
Public Class Example
Public Shared Sub Main()
Dim str As String
Dim pad As Char
str = "forty-two"
pad = "."c
Console.WriteLine(str.PadLeft(15, pad))
Console.WriteLine(str.PadLeft(2, pad))
End Sub
End Class
' The example displays the following output:
' ......forty-two
' forty-two
Uwagi
Metoda PadLeft(Int32, Char) dopełnia początek zwracanego ciągu. Oznacza to, że w przypadku użycia z językami od prawej do lewej dopełnia prawą część ciągu.
Uwaga
PadLeft Jeśli metoda dopełnia bieżące wystąpienie znakami odstępu, ta metoda nie modyfikuje wartości bieżącego wystąpienia. Zamiast tego zwraca nowy ciąg wypełniony znakami wiodącymi paddingChar , tak aby jego łączna długość to totalWidth znaki.
Zobacz też
Dotyczy
.NET 9 i inne wersje
| Produkt | Wersje |
|---|---|
| .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 |
- Źródło:
- String.Manipulation.cs
- Źródło:
- String.Manipulation.cs
- Źródło:
- String.Manipulation.cs
Zwraca nowy ciąg, który wyrównuje znaki w tym wystąpieniu, dopełniając je spacjami po lewej stronie dla określonej całkowitej długości.
public:
System::String ^ PadLeft(int totalWidth);public string PadLeft (int totalWidth);member this.PadLeft : int -> stringPublic Function PadLeft (totalWidth As Integer) As StringParametry
- totalWidth
- Int32
Liczba znaków w ciągu wynikowym, równa liczbie oryginalnych znaków i znaków dodatkowych dopełnienia.
Zwraca
Nowy ciąg, który jest odpowiednikiem tego wystąpienia, ale wyrównany do prawej i dopełniony po lewej stronie z dowolną liczbą spacji, aby utworzyć długość totalWidth. Jeśli jednak totalWidth jest mniejsza niż długość tego wystąpienia, metoda zwraca odwołanie do istniejącego wystąpienia. Jeśli totalWidth jest równa długości tego wystąpienia, metoda zwraca nowy ciąg, który jest identyczny z tym wystąpieniem.
Wyjątki
Parametr totalWidth ma wartość niższą niż zero.
Przykłady
W poniższym przykładzie pokazano metodę PadLeft .
String^ str = "BBQ and Slaw";
Console::WriteLine( str->PadLeft( 15 ) ); // Displays " BBQ and Slaw".
Console::WriteLine( str->PadLeft( 5 ) ); // Displays "BBQ and Slaw".
string str = "BBQ and Slaw";
Console.WriteLine(str.PadLeft(15)); // Displays " BBQ and Slaw".
Console.WriteLine(str.PadLeft(5)); // Displays "BBQ and Slaw".
let str = "BBQ and Slaw"
printfn $"{str.PadLeft 15}" // Displays " BBQ and Slaw".
printfn $"{str.PadLeft 5}" // Displays "BBQ and Slaw".
Dim str As String
str = "BBQ and Slaw"
Console.WriteLine(str.PadLeft(15)) ' Displays " BBQ and Slaw".
Console.WriteLine(str.PadLeft(5)) ' Displays "BBQ and Slaw".
Uwagi
Przestrzeń Unicode jest definiowana jako 0x0020 szesnastkowa.
Metoda PadLeft(Int32) dopełnia początek zwracanego ciągu. Oznacza to, że w przypadku użycia z językami od prawej do lewej dopełnia prawą część ciągu.
Uwaga
PadLeft Jeśli metoda dopełnia bieżące wystąpienie znakami odstępu, ta metoda nie modyfikuje wartości bieżącego wystąpienia. Zamiast tego zwraca nowy ciąg, który jest wypełniony wiodącym odstępem, tak aby jego łączna długość to totalWidth znaki.
Zobacz też
Dotyczy
.NET 9 i inne wersje
| Produkt | Wersje |
|---|---|
| .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 |
Opinia o produkcie .NET
.NET to projekt typu open source. Wybierz link, aby przekazać opinię: