MaskedTextProvider.InsertAt Metoda

Definice

Obor názvů:

System.ComponentModel

Sestavení:

System.ComponentModel.TypeConverter.dll

Vloží znak nebo řetězec na určitou pozici v rámci formátovaného řetězce.

Přetížení

InsertAt(Char, Int32)	Vloží zadaný znak na zadanou pozici v rámci formátovaného řetězce.
InsertAt(String, Int32)	Vloží zadaný řetězec na zadanou pozici v rámci formátovaného řetězce.
InsertAt(Char, Int32, Int32, MaskedTextResultHint)	Vloží zadaný znak na zadanou pozici v rámci formátovaného řetězce a vrátí poslední pozici vložení a stav operace.
InsertAt(String, Int32, Int32, MaskedTextResultHint)	Vloží zadaný řetězec na zadanou pozici v rámci formátovaného řetězce a vrátí poslední pozici vložení a stav operace.

InsertAt(Char, Int32)

Zdroj:

MaskedTextProvider.cs

Vloží zadaný znak na zadanou pozici v rámci formátovaného řetězce.

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

Hodnota Char , která se má vložit.

position

Int32

Pozice založená na nule ve formátovaného řetězci pro vložení znaku.

Návraty

Boolean

truepokud bylo vložení úspěšné; v opačném případě . false

Poznámky

Metoda InsertAt vloží znak do první pozice pro úpravy na nebo mimo místo určené parametrem pos . Tato metoda posune všechny existující znaky za kurzorem o jednu pozici, aby se uvolnilo místo pro vložený input znak. Pokud dojde k některé z následujících chyb, vložení se neprovádí a metoda vrátí false.

• Parametr pos je menší než nula nebo větší než Length hodnota formátovaného řetězce.

• Ve formátovaného řetězci nebyl nalezen upravitelný znak na zadané pozici nebo za ním. pos

• Znak vložení není platným vstupním znakem, inputprotože se nedá vytisknout nebo neodpovídá odpovídajícímu prvku masky.

• Napravo od kurzoru nejsou k dispozici žádné pozice, takže existující znaky nelze posunout.

• Posunutí existujících znaků způsobí porušení masky.

Prázdný input řetězec nezpůsobí žádnou změnu formátovaného řetězce, ale vrátí true.

Viz také

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

InsertAt(String, Int32)

Zdroj:

MaskedTextProvider.cs

Vloží zadaný řetězec na zadanou pozici v rámci formátovaného řetězce.

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

Hodnota String , která se má vložit.

position

Int32

Pozice založená na nule ve formátovaného řetězci pro vložení vstupního řetězce.

Návraty

Boolean

truepokud bylo vložení úspěšné; v opačném případě . false

Výjimky

ArgumentNullException

Parametr input je null.

Poznámky

Metoda InsertAt vloží každý znak z input řetězce do editačních pozic umístěných na pozici pos a dále. Tato metoda posune všechny existující znaky za kurzorem o jednu pozici pro každý vložený znak. Pokud dojde k některé z následujících chyb, neprovádí se žádné vložení a metoda vrátí false.

• Parametr pos je menší než nula nebo větší než Length hodnota formátovaného řetězce.

• Ve formátovaných řetězech na zadané pozici nebo mimo ni neexistuje dostatek upravitelných znaků, posaby bylo možné vložit všechny znaky z input řetězce.

• Jeden nebo více znaků vložení není platným vstupním znakem, protože je nelze vytisknout nebo neodpovídají odpovídajícímu prvku masky.

• Napravo od kurzoru není dostatek dostupných pozic, takže existující znaky nelze posunout.

• Posunutí existujících znaků způsobí porušení masky. Všimněte si, že k tomuto posunu dochází při vkládání jednotlivých znaků.

Prázdný input řetězec nezpůsobí žádnou změnu formátovaného řetězce, ale vrátí true.

Viz také

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

InsertAt(Char, Int32, Int32, MaskedTextResultHint)

Zdroj:

MaskedTextProvider.cs

Vloží zadaný znak na zadanou pozici v rámci formátovaného řetězce a vrátí poslední pozici vložení a stav operace.

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

Hodnota Char , která se má vložit.

position

Int32

Pozice založená na nule ve formátovaného řetězci pro vložení znaku.

testPosition

Int32

Pokud je metoda úspěšná, poslední pozice, kam byl vložen znak; v opačném případě první místo, kde se vložení nezdařilo. Výstupní parametr.

resultHint

MaskedTextResultHint

A MaskedTextResultHint , který stručně popisuje výsledek operace vložení. Výstupní parametr.

Návraty

Boolean

truepokud bylo vložení úspěšné; v opačném případě . false

Poznámky

Metoda InsertAt vloží znak do první pozice pro úpravy na nebo mimo místo určené parametrem pos . Tato metoda posune všechny existující znaky za kurzorem o jednu pozici, aby se uvolnilo místo pro vložený input znak. Pokud dojde k některé z následujících chyb, vložení se neprovádí a metoda vrátí false.

• Parametr pos je menší než nula nebo větší než Length hodnota formátovaného řetězce.

• Ve formátovaného řetězci nebyl nalezen upravitelný znak na zadané pozici nebo za ním. pos

• Znak vložení není platným vstupním znakem, inputprotože se nedá vytisknout nebo neodpovídá odpovídajícímu prvku masky.

• Napravo od kurzoru nejsou k dispozici žádné pozice, takže existující znaky nelze posunout.

• Posunutí existujících znaků způsobí porušení masky.

Prázdný input řetězec nezpůsobí žádnou změnu formátovaného řetězce, ale vrátí true.

Viz také

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

InsertAt(String, Int32, Int32, MaskedTextResultHint)

Zdroj:

MaskedTextProvider.cs

Vloží zadaný řetězec na zadanou pozici v rámci formátovaného řetězce a vrátí poslední pozici vložení a stav operace.

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

Hodnota String , která se má vložit.

position

Int32

Pozice založená na nule ve formátovaného řetězci pro vložení vstupního řetězce.

testPosition

Int32

Pokud je metoda úspěšná, poslední pozice, kam byl vložen znak; v opačném případě první místo, kde se vložení nezdařilo. Výstupní parametr.

resultHint

MaskedTextResultHint

A MaskedTextResultHint , který stručně popisuje výsledek operace vložení. Výstupní parametr.

Návraty

Boolean

truepokud bylo vložení úspěšné; v opačném případě . false

Výjimky

ArgumentNullException

Parametr input je null.

Poznámky

Metoda InsertAt vloží každý znak z input řetězce do editačních pozic umístěných na pozici pos a dále. Tato metoda posune všechny existující znaky za kurzorem o jednu pozici pro každý vložený znak. Pokud dojde k některé z následujících chyb, neprovádí se žádné vložení a metoda vrátí false.

• Parametr pos je menší než nula nebo větší než Length hodnota formátovaného řetězce.

• Ve formátovaných řetězech na zadané pozici nebo mimo ni neexistuje dostatek upravitelných znaků, posaby bylo možné vložit všechny znaky z input řetězce.

• Jeden nebo více znaků vložení není platným vstupním znakem, protože je nelze vytisknout nebo neodpovídají odpovídajícímu prvku masky.

• Napravo od kurzoru není dostatek dostupných pozic, takže existující znaky nelze posunout.

• Posunutí existujících znaků způsobí porušení masky. Všimněte si, že k tomuto posunu dochází při vkládání jednotlivých znaků.

Prázdný input řetězec nezpůsobí žádnou změnu formátovaného řetězce, ale vrátí true.

Viz také

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