StringInfo.SubstringByTextElements Método

Definição

Namespace:

System.Globalization

Assembly:

System.Runtime.dll

Recupera uma subcadeia de caracteres dos elementos de texto do objeto StringInfo atual.

Sobrecargas

SubstringByTextElements(Int32)	Recupera uma subcadeia de caracteres dos elementos de texto objeto StringInfo atual começando em um elemento de texto especificado e continuando até o último elemento de texto.
SubstringByTextElements(Int32, Int32)	Recupera uma subcadeia de caracteres dos elementos de texto objeto StringInfo atual começando em um elemento de texto especificado e continuando pelo número de elementos de texto especificado.

SubstringByTextElements(Int32)

Origem:

StringInfo.cs

Recupera uma subcadeia de caracteres dos elementos de texto objeto StringInfo atual começando em um elemento de texto especificado e continuando até o último elemento de texto.

public:
 System::String ^ SubstringByTextElements(int startingTextElement);

public string SubstringByTextElements (int startingTextElement);

member this.SubstringByTextElements : int -> string

Public Function SubstringByTextElements (startingTextElement As Integer) As String

Parâmetros

startingTextElement

Int32

O índice baseado em zero de um elemento de texto nesse objeto StringInfo.

Retornos

String

Uma subcadeia de elementos de texto nesse objeto StringInfo, começando no índice do elemento de texto especificado pelo parâmetro startingTextElement e continuando até o último elemento de texto nesse objeto.

Exceções

ArgumentOutOfRangeException

startingTextElement é menor que zero.

- ou -

A cadeia de caracteres que é o valor do objeto StringInfo atual é a cadeia de caracteres vazia ("").

Comentários

Considere uma cadeia de caracteres que consiste em cinco elementos de texto, indexados de 0 a 4. Se o startingTextElement parâmetro for 1, o SubstringByTextElements método retornará uma subcadeia de caracteres que consiste nos elementos de texto para os quais os índices são 1, 2, 3 e 4.

SubstringByTextElements(Int32, Int32)

Origem:

StringInfo.cs

Recupera uma subcadeia de caracteres dos elementos de texto objeto StringInfo atual começando em um elemento de texto especificado e continuando pelo número de elementos de texto especificado.

public:
 System::String ^ SubstringByTextElements(int startingTextElement, int lengthInTextElements);

public string SubstringByTextElements (int startingTextElement, int lengthInTextElements);

member this.SubstringByTextElements : int * int -> string

Public Function SubstringByTextElements (startingTextElement As Integer, lengthInTextElements As Integer) As String

Parâmetros

startingTextElement

Int32

O índice baseado em zero de um elemento de texto nesse objeto StringInfo.

lengthInTextElements

Int32

O número de elementos de texto a serem recuperados.

Retornos

String

Uma subcadeia de caracteres de elementos de texto nesse objeto StringInfo. A subcadeia de caracteres consiste no número de elementos de texto especificado pelo parâmetro lengthInTextElements começa no índice de elemento de texto especificado pelo parâmetro startingTextElement.

Exceções

ArgumentOutOfRangeException

startingTextElement é menor que zero.

- ou -

startingTextElement é maior que ou igual ao comprimento da cadeia de caracteres que é o valor do objeto StringInfo atual.

- ou -

lengthInTextElements é menor que zero.

- ou -

A cadeia de caracteres que é o valor do objeto StringInfo atual é a cadeia de caracteres vazia ("").

- ou -

startingTextElement + lengthInTextElements especificam um índice maior que o número de elementos de texto nesse objeto StringInfo.

Comentários

Considere uma cadeia de caracteres que consiste em cinco elementos de texto, indexados de 0 a 4. Se o startingTextElement parâmetro for 1 e o lengthInTextElements parâmetro for 3, o SubstringByTextElements método retornará uma subcadeia de caracteres que consiste nos elementos de texto para os quais os índices são 1, 2 e 3.