MaskedTextProvider.Add Yöntem

Tanım

Ad Alanı:

System.ComponentModel

Bütünleştirilmiş Kod:

System.ComponentModel.TypeConverter.dll

Biçimlendirilmiş dizeye bir giriş karakteri veya giriş dizesi ekler.

Aşırı Yüklemeler

Add(String, Int32, MaskedTextResultHint)	Belirtilen giriş dizesindeki karakterleri biçimlendirilmiş dizenin sonuna ekler ve ardından konum ve açıklayıcı bilgileri çıkarır.
Add(Char, Int32, MaskedTextResultHint)	Belirtilen giriş karakterini biçimlendirilmiş dizenin sonuna ekler ve ardından konum ve açıklayıcı bilgileri verir.
Add(Char)	Belirtilen giriş karakterini biçimlendirilmiş dizenin sonuna ekler.
Add(String)	Belirtilen giriş dizesindeki karakterleri biçimlendirilmiş dizenin sonuna ekler.

Add(String, Int32, MaskedTextResultHint)

Kaynak:

MaskedTextProvider.cs

Belirtilen giriş dizesindeki karakterleri biçimlendirilmiş dizenin sonuna ekler ve ardından konum ve açıklayıcı bilgileri çıkarır.

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

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

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

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

Parametreler

input

String

String Biçimlendirilmiş dizeye eklenecek karakter değerlerini içeren.

testPosition

Int32

Biçimlendirilmiş dizede, karakteri ekleme girişiminde bulunulduğu sıfır tabanlı konum. Çıkış parametresi.

resultHint

MaskedTextResultHint

MaskedTextResultHint İşlemin sonucunu kısaca açıklayan bir. Çıkış parametresi.

Döndürülenler

Boolean

true giriş dizesinden tüm karakterler başarıyla eklendiyse; aksi takdirde false hiçbir karakter eklenmediğini belirtir.

Açıklamalar

yöntemi, Add(String, Int32, MaskedTextResultHint) dizedeki input karakterleri, sonrasındaki LastAssignedPositionkullanılabilir ilk konumdan başlayarak biçimlendirilmiş dizeye ekler. Bu yöntem aşağıdaki nedenlerden herhangi biri nedeniyle başarısız olur:

• giriş değerindeki inputkarakterlerden hiçbiri yazdırılamaz veya giriş değeri karşılık gelen maske öğesiyle eşleşmiyor.

• Son atanan konumdan sonra biçimlendirilmiş dizede yeterli kullanılabilir düzenleme konumu yok.

Bu yöntem başarısız olursa, hiçbir ekleme yapılmaz ve yöntemi döndürür false.

Bu yöntem, ek bilgi çıkışı oluşturması dışında tek StringAdd(String)bir parametre alan geçersiz kılınan sürümle aynı işlevi görür.

Ayrıca bkz.

• Replace
• Remove
• InsertAt
• Clear
• Set
• AvailableEditPositionCount
• LastAssignedPosition
• IsValidInputChar(Char)
• VerifyString

Add(Char, Int32, MaskedTextResultHint)

Kaynak:

MaskedTextProvider.cs

Belirtilen giriş karakterini biçimlendirilmiş dizenin sonuna ekler ve ardından konum ve açıklayıcı bilgileri verir.

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

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

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

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

Parametreler

input

Char

Char Biçimlendirilmiş dizeye eklenecek değer.

testPosition

Int32

Biçimlendirilmiş dizede, karakteri ekleme girişiminde bulunulduğu sıfır tabanlı konum. Çıkış parametresi.

resultHint

MaskedTextResultHint

MaskedTextResultHint İşlemin sonucunu kısaca açıklayan bir. Çıkış parametresi.

Döndürülenler

Boolean

true giriş karakteri başarıyla eklendiyse; aksi takdirde false.

Açıklamalar

yöntemi, Add(Char, Int32, MaskedTextResultHint) karakter değerini, özelliğiyle LastAssignedPosition temsil edilen son atanan konumdan sonra biçimlendirilmiş dizedeki kullanılabilir ilk konuma eklemeyi input dener. Tüm kullanılabilir konumlar son atanan konumdan önceyse bu yöntem başarısız olur. Bu yöntem aşağıdaki nedenlerden herhangi biri nedeniyle başarısız olur:

• giriş değeri, inputyazdırılamaz veya karşılık gelen maske öğesiyle eşleşmiyor.

• Biçimlendirilmiş dizede kullanılabilir düzenleme konumu yok veya son atanan konumdan sonra kullanılabilir düzenleme konumu yok.

Bu yöntem, ek bilgi çıkışı oluşturması dışında tek CharAdd(Char)bir parametre alan geçersiz kılınan sürümle aynı işlevi görür.

Ayrıca bkz.

• Replace
• Remove
• InsertAt
• Clear
• Set
• AvailableEditPositionCount
• LastAssignedPosition
• IsValidInputChar(Char)
• VerifyChar(Char, Int32, MaskedTextResultHint)

Add(Char)

Kaynak:

MaskedTextProvider.cs

Belirtilen giriş karakterini biçimlendirilmiş dizenin sonuna ekler.

public:
 bool Add(char input);

public bool Add (char input);

member this.Add : char -> bool

Public Function Add (input As Char) As Boolean

Parametreler

input

Char

Char Biçimlendirilmiş dizeye eklenecek değer.

Döndürülenler

Boolean

true giriş karakteri başarıyla eklendiyse; aksi takdirde false.

Açıklamalar

yöntemi, Add(Char) karakter değerini, özelliğiyle temsil edilen son atanan konumdan sonra biçimlendirilmiş dizedeki LastAssignedPosition kullanılabilir ilk konuma eklerinput. Bu yöntem aşağıdaki nedenlerden herhangi biri nedeniyle başarısız olur:

• giriş değeri, inputyazdırılamaz veya karşılık gelen maske öğesiyle eşleşmiyor.

• Biçimlendirilmiş dizede kullanılabilir düzenleme konumu yok veya son atanan konumdan sonra kullanılabilir düzenleme konumu yok.

Ayrıca bkz.

• Replace
• Remove
• InsertAt
• Clear
• Set
• AvailableEditPositionCount
• LastAssignedPosition
• IsValidInputChar(Char)
• VerifyChar(Char, Int32, MaskedTextResultHint)

Add(String)

Kaynak:

MaskedTextProvider.cs

Belirtilen giriş dizesindeki karakterleri biçimlendirilmiş dizenin sonuna ekler.

public:
 bool Add(System::String ^ input);

public bool Add (string input);

member this.Add : string -> bool

Public Function Add (input As String) As Boolean

Parametreler

input

String

String Biçimlendirilmiş dizeye eklenecek karakter değerlerini içeren.

Döndürülenler

Boolean

true giriş dizesinden tüm karakterler başarıyla eklendiyse; aksi takdirde false hiçbir karakter eklenmediğini belirtir.

Özel durumlar

ArgumentNullException

input parametresidirnull.

Açıklamalar

yöntemi, Add(String) dizedeki input karakterleri, sonrasındaki LastAssignedPositionkullanılabilir ilk konumdan başlayarak biçimlendirilmiş dizeye ekler. Bu yöntem aşağıdaki nedenlerden herhangi biri nedeniyle başarısız olur:

• giriş değerindeki inputkarakterlerden hiçbiri yazdırılamaz veya giriş değeri karşılık gelen maske öğesiyle eşleşmiyor.

• Son atanan konumdan sonra biçimlendirilmiş dizede yeterli kullanılabilir düzenleme konumu yok.

Bu yöntem başarısız olursa, hiçbir ekleme yapılmaz ve yöntemi döndürür false.

Ayrıca bkz.

• Replace
• Remove
• InsertAt
• Clear
• Set
• AvailableEditPositionCount
• LastAssignedPosition
• IsValidInputChar(Char)
• VerifyString