StringInfo.GetNextTextElement Yöntem

Tanım

Ad Alanı:

System.Globalization

Bütünleştirilmiş Kod:

System.Runtime.dll

Belirtilen dizedeki ilk metin öğesini alır.

Aşırı Yüklemeler

GetNextTextElement(String)	Belirtilen dizedeki ilk metin öğesini alır.
GetNextTextElement(String, Int32)	Belirtilen dizenin belirtilen dizinindeki metin öğesini alır.

GetNextTextElement(String)

Kaynak:

StringInfo.cs

Belirtilen dizedeki ilk metin öğesini alır.

public:
 static System::String ^ GetNextTextElement(System::String ^ str);

public static string GetNextTextElement (string str);

static member GetNextTextElement : string -> string

Public Shared Function GetNextTextElement (str As String) As String

Parametreler

str

String

Metin öğesinin alındığı dize.

Döndürülenler

String

Belirtilen dizedeki ilk metin öğesini içeren dize.

Özel durumlar

ArgumentNullException

str, null değeridir.

Açıklamalar

.NET, bir metin öğesini tek karakter, yani grafeme olarak görüntülenen bir metin birimi olarak tanımlar. Metin öğesi bir temel karakter, vekil çift veya birleşen karakter dizisi olabilir. Unicode Standardı, bir vekil çifti, çiftin ilk biriminin yüksek vekil, ikincisinin ise düşük vekil olduğu iki kod biriminden oluşan bir diziden oluşan tek bir soyut karakter için kodlanmış karakter gösterimi olarak tanımlar. Unicode Standart, bir birleştirme karakter dizisini bir temel karakter ve bir veya daha fazla birleştirme karakterinin birleşimi olarak tanımlar. Vekil çift, bir temel karakteri veya birleşen karakteri temsil edebilir.

Bu yöntem yalnızca ilk metin öğesini döndürür. Dizenin metin öğelerinde yineleme yapmak için uygulamanın yöntemi tarafından GetTextElementEnumerator oluşturulan nesnesini kullanması TextElementEnumerator gerekir.

Ayrıca bkz.

• GetTextElementEnumerator(String)
• ParseCombiningCharacters(String)

GetNextTextElement(String, Int32)

Kaynak:

StringInfo.cs

Belirtilen dizenin belirtilen dizinindeki metin öğesini alır.

public:
 static System::String ^ GetNextTextElement(System::String ^ str, int index);

public static string GetNextTextElement (string str, int index);

static member GetNextTextElement : string * int -> string

Public Shared Function GetNextTextElement (str As String, index As Integer) As String

Parametreler

str

String

Metin öğesinin alındığı dize.

index

Int32

Metin öğesinin başladığı sıfır tabanlı dizin.

Döndürülenler

String

Belirtilen dizenin belirtilen dizininde metin öğesini içeren bir dize.

Özel durumlar

ArgumentNullException

str, null değeridir.

ArgumentOutOfRangeException

index için geçerli dizin straralığının dışındadır.

Açıklamalar

.NET, bir metin öğesini tek karakter, yani grafeme olarak görüntülenen bir metin birimi olarak tanımlar. Metin öğesi bir temel karakter, vekil çift veya birleşen karakter dizisi olabilir. Unicode Standardı, bir vekil çifti, çiftin ilk biriminin yüksek vekil, ikincisinin ise düşük vekil olduğu iki kod biriminden oluşan bir diziden oluşan tek bir soyut karakter için kodlanmış karakter gösterimi olarak tanımlar. Unicode Standart, bir birleştirme karakter dizisini bir temel karakter ve bir veya daha fazla birleştirme karakterinin birleşimi olarak tanımlar. Vekil çift, bir temel karakteri veya birleşen karakteri temsil edebilir.

Bu yöntem yalnızca belirtilen dizinde başlayan alt dizenin ilk metin öğesini döndürür. Dizenin metin öğelerini yinelemek için uygulamanın yöntemi tarafından oluşturulan öğesini TextElementEnumeratorGetTextElementEnumerator kullanması gerekir.

Ayrıca bkz.

• GetTextElementEnumerator(String)
• ParseCombiningCharacters(String)