MaskedTextProvider.InsertAt Metoda

Definicja

Przestrzeń nazw:

System.ComponentModel

Zestaw:

System.ComponentModel.TypeConverter.dll

Wstawia znak lub ciąg w określonej pozycji w sformatowanym ciągu.

Przeciążenia

InsertAt(Char, Int32)	Wstawia określony znak w określonym położeniu w sformatowany ciąg.
InsertAt(String, Int32)	Wstawia określony ciąg w określonej pozycji w sformatowanym ciągu.
InsertAt(Char, Int32, Int32, MaskedTextResultHint)	Wstawia określony znak na określonej pozycji w sformatowany ciąg, zwracając ostatnią pozycję wstawiania i stan operacji.
InsertAt(String, Int32, Int32, MaskedTextResultHint)	Wstawia określony ciąg w określonej pozycji w sformatowanym ciągu, zwracając ostatnią pozycję wstawiania i stan operacji.

InsertAt(Char, Int32)

Źródło:

MaskedTextProvider.cs

Wstawia określony znak w określonym położeniu w sformatowany ciąg.

public:
 bool InsertAt(char input, int position);

public bool InsertAt (char input, int position);

member this.InsertAt : char * int -> bool

Public Function InsertAt (input As Char, position As Integer) As Boolean

Parametry

input

Char

Element Char do wstawienia.

position

Int32

Pozycja oparta na zera w sformatowanym ciągu w celu wstawienia znaku.

Zwraca

Boolean

true jeśli wstawienie zakończyło się pomyślnie; w przeciwnym razie , false.

Uwagi

Metoda InsertAt wstawia znak do pierwszej pozycji edycji na poziomie lub poza tym określonym przez pos parametr . Ta metoda spowoduje przesunięcie wszystkich istniejących znaków po punkcie wstawiania przez jedną pozycję, aby umieścić miejsce dla wstawionego input znaku. Jeśli wystąpi jeden z następujących błędów, wstawienie nie zostanie wykonane, a metoda zwróci wartość false.

• Parametr pos jest mniejszy niż zero lub większy niż Length sformatowany ciąg.

• Nie można odnaleźć edytowalnego znaku w sformatowanym ciągu w określonej pozycji poslub poza nią.

• Znak wstawiania , nie jest prawidłowym znakiem wejściowym, inputponieważ nie jest drukowalny lub nie jest zgodny z odpowiednim elementem maski.

• Po prawej stronie punktu wstawiania nie ma dostępnych pozycji, dzięki czemu istniejące znaki nie mogą być przesunięte.

• Przesunięcie istniejących znaków spowodowałoby naruszenie maski.

Pusty input ciąg nie spowoduje zmiany w sformatowanym ciągu, ale zwróci truewartość .

Zobacz też

• Add
• AvailableEditPositionCount
• Mask
• Remove
• Replace
• Set
• ToDisplayString()
• VerifyString

InsertAt(String, Int32)

Źródło:

MaskedTextProvider.cs

Wstawia określony ciąg w określonej pozycji w sformatowanym ciągu.

public:
 bool InsertAt(System::String ^ input, int position);

public bool InsertAt (string input, int position);

member this.InsertAt : string * int -> bool

Public Function InsertAt (input As String, position As Integer) As Boolean

Parametry

input

String

Element String do wstawienia.

position

Int32

Pozycja oparta na zera w sformatowanym ciągu w celu wstawienia ciągu wejściowego.

Zwraca

Boolean

true jeśli wstawienie zakończyło się pomyślnie; w przeciwnym razie , false.

Wyjątki

ArgumentNullException

Parametr input to null.

Uwagi

Metoda InsertAt wstawia każdy znak z input ciągu do pozycji edycji znajdujących się w pozycji pos i poza nią. Ta metoda spowoduje przesunięcie wszystkich istniejących znaków po punkcie wstawiania na jedną pozycję dla każdego wstawionego znaku. Jeśli wystąpi jeden z następujących błędów, nie jest wykonywane wstawienie, a metoda zwraca falsewartość .

• Parametr pos jest mniejszy niż zero lub większy niż Length sformatowany ciąg.

• Za mało edytowalnych znaków istnieje w sformatowanym ciągu w określonej pozycji lub poza nią, posaby wstawić wszystkie znaki z input ciągu.

• Co najmniej jeden znak wstawiania nie jest prawidłowym znakiem wejściowym, ponieważ nie można ich wydrukować lub nie pasuje do odpowiedniego elementu maski.

• Po prawej stronie punktu wstawiania nie ma wystarczającej liczby dostępnych pozycji, aby nie można było przesunąć istniejących znaków.

• Przesunięcie istniejących znaków spowodowałoby naruszenie maski. Należy pamiętać, że to przesunięcie odbywa się podczas wstawiania każdego pojedynczego znaku.

Pusty input ciąg nie spowoduje zmiany w sformatowanym ciągu, ale zwróci truewartość .

Zobacz też

• Add
• AvailableEditPositionCount
• Mask
• Remove
• Replace
• Set
• ToDisplayString()
• VerifyString

InsertAt(Char, Int32, Int32, MaskedTextResultHint)

Źródło:

MaskedTextProvider.cs

Wstawia określony znak na określonej pozycji w sformatowany ciąg, zwracając ostatnią pozycję wstawiania i stan operacji.

public:
 bool InsertAt(char input, int position, [Runtime::InteropServices::Out] int % testPosition, [Runtime::InteropServices::Out] System::ComponentModel::MaskedTextResultHint % resultHint);

public bool InsertAt (char input, int position, out int testPosition, out System.ComponentModel.MaskedTextResultHint resultHint);

member this.InsertAt : char * int * int * MaskedTextResultHint -> bool

Public Function InsertAt (input As Char, position As Integer, ByRef testPosition As Integer, ByRef resultHint As MaskedTextResultHint) As Boolean

Parametry

input

Char

Element Char do wstawienia.

position

Int32

Pozycja oparta na zera w sformatowanym ciągu w celu wstawienia znaku.

testPosition

Int32

Jeśli metoda zakończy się pomyślnie, ostatnia pozycja, w której wstawiono znak; w przeciwnym razie pierwsza pozycja, w której wstawianie nie powiodło się. Parametr wyjściowy.

resultHint

MaskedTextResultHint

Ten MaskedTextResultHint zwięzły opis wyniku operacji wstawiania. Parametr wyjściowy.

Zwraca

Boolean

true jeśli wstawienie zakończyło się pomyślnie; w przeciwnym razie , false.

Uwagi

Metoda InsertAt wstawia znak do pierwszej pozycji edycji na poziomie lub poza tym określonym przez pos parametr . Ta metoda spowoduje przesunięcie wszystkich istniejących znaków po punkcie wstawiania przez jedną pozycję, aby umieścić miejsce dla wstawionego input znaku. Jeśli wystąpi jeden z następujących błędów, wstawienie nie zostanie wykonane, a metoda zwróci wartość false.

• Parametr pos jest mniejszy niż zero lub większy niż Length sformatowany ciąg.

• Nie można odnaleźć edytowalnego znaku w sformatowanym ciągu w określonej pozycji poslub poza nią.

• Znak wstawiania , nie jest prawidłowym znakiem wejściowym, inputponieważ nie jest drukowalny lub nie jest zgodny z odpowiednim elementem maski.

• Po prawej stronie punktu wstawiania nie ma dostępnych pozycji, dzięki czemu istniejące znaki nie mogą być przesunięte.

• Przesunięcie istniejących znaków spowodowałoby naruszenie maski.

Pusty input ciąg nie spowoduje zmiany w sformatowanym ciągu, ale zwróci truewartość .

Zobacz też

• Add
• AvailableEditPositionCount
• Mask
• Remove
• Replace
• Set
• ToDisplayString()
• VerifyString

InsertAt(String, Int32, Int32, MaskedTextResultHint)

Źródło:

MaskedTextProvider.cs

Wstawia określony ciąg w określonej pozycji w sformatowanym ciągu, zwracając ostatnią pozycję wstawiania i stan operacji.

public:
 bool InsertAt(System::String ^ input, int position, [Runtime::InteropServices::Out] int % testPosition, [Runtime::InteropServices::Out] System::ComponentModel::MaskedTextResultHint % resultHint);

public bool InsertAt (string input, int position, out int testPosition, out System.ComponentModel.MaskedTextResultHint resultHint);

member this.InsertAt : string * int * int * MaskedTextResultHint -> bool

Public Function InsertAt (input As String, position As Integer, ByRef testPosition As Integer, ByRef resultHint As MaskedTextResultHint) As Boolean

Parametry

input

String

Element String do wstawienia.

position

Int32

Pozycja oparta na zera w sformatowanym ciągu w celu wstawienia ciągu wejściowego.

testPosition

Int32

Jeśli metoda zakończy się pomyślnie, ostatnia pozycja, w której wstawiono znak; w przeciwnym razie pierwsza pozycja, w której wstawianie nie powiodło się. Parametr wyjściowy.

resultHint

MaskedTextResultHint

Ten MaskedTextResultHint zwięzły opis wyniku operacji wstawiania. Parametr wyjściowy.

Zwraca

Boolean

true jeśli wstawienie zakończyło się pomyślnie; w przeciwnym razie , false.

Wyjątki

ArgumentNullException

Parametr input to null.

Uwagi

Metoda InsertAt wstawia każdy znak z input ciągu do pozycji edycji znajdujących się w pozycji pos i poza nią. Ta metoda spowoduje przesunięcie wszystkich istniejących znaków po punkcie wstawiania na jedną pozycję dla każdego wstawionego znaku. Jeśli wystąpi jeden z następujących błędów, nie jest wykonywane wstawienie, a metoda zwraca falsewartość .

• Parametr pos jest mniejszy niż zero lub większy niż Length sformatowany ciąg.

• Za mało edytowalnych znaków istnieje w sformatowanym ciągu w określonej pozycji lub poza nią, posaby wstawić wszystkie znaki z input ciągu.

• Co najmniej jeden znak wstawiania nie jest prawidłowym znakiem wejściowym, ponieważ nie można ich wydrukować lub nie pasuje do odpowiedniego elementu maski.

• Po prawej stronie punktu wstawiania nie ma wystarczającej liczby dostępnych pozycji, aby nie można było przesunąć istniejących znaków.

• Przesunięcie istniejących znaków spowodowałoby naruszenie maski. Należy pamiętać, że to przesunięcie odbywa się podczas wstawiania każdego pojedynczego znaku.

Pusty input ciąg nie spowoduje zmiany w sformatowanym ciągu, ale zwróci truewartość .

Zobacz też

• Add
• AvailableEditPositionCount
• Mask
• Remove
• Replace
• Set
• ToDisplayString()
• VerifyString