Função Right (Visual Basic)

Retorna uma sequência de caracteres contendo um número especificado de caracteres a partir do lado direito de uma sequência de caracteres.

Public Shared Function Right( _
   ByVal str As String, _
   ByVal Length As Integer _
) As String

Parâmetros

• str
  Obrigatório.String expressão do qual os caracteres mais à direita são retornados.

• Length
  Obrigatório.Integer.Expressão numérica indicando quantos caracteres para retornar.Se for zero, uma sequência de caracteres de comprimento zero (" ") será retornada.Se maior ou igual ao número de caracteres em str, a sequência completa será retornada.

Exceções

Tipo de exceção	Número de erro	Condição
ArgumentException	5	Length < 0.

Ver a coluna " número de erro " se você estiver atualizando aplicativos Visual Basic 6.0 que usam manipulação de erros não estruturada.(Você pode comparar o número do erro com a Propriedade do Número (Erro de objeto).) Entretanto, quando for possivel, você pode considerar substituir tal controle de erro por Visão Geral sobre a Manipulação Estruturada de Exceções para o Visual Basic.

Comentários

Para determinar o número de caracteres em str, use a função Len.Se for usado em um aplicativo Formulário do Windows, ou qualquer outra classe que tenha uma propriedade Right, você deve qualificar totalmente a função com Microsoft.VisualBasic.Right.

Observação:
O RightB função nas versões anteriores do Visual Basic retorna uma seqüência de caracteres em bytes, em vez de caracteres. Isso é usado primariamente para converter strings em aplicações com conjuntos de caracteres de byte duplo (DBCS).Todas sequências de caracteres do Visual Basic estão em Unicode, e RightB não é mais suportado.

Exemplo

Este exemplo demonstra o uso da função Right para retornar uma subsequência de caracteres de uma determinada String.Em uma classe que tem uma propriedade Right, talvez seja necessário qualificar totalmente a função Right.

Dim TestString As String = "Hello World!"
' Returns "World!".
Dim subString As String = Microsoft.VisualBasic.Right(TestString, 6)

Requisitos

Namespace:Microsoft.VisualBasic

**Módulo:**Strings

Assembly: Visual Basic Runtime Library (em Microsoft.VisualBasic.dll)

Consulte também

Conceitos

Sumário para programação de mudanças em elementos de suporte

Referência

Sumário de Manipulação de Strings

Função Left (Visual Basic)

Função Len (Visual Basic)

Função Mid (Visual Basic)

ArgumentException