Declaração Intercalar

Substitui um número especificado de caracteres em uma String variável por caracteres de outra cadeia de caracteres.

Sintaxe

Mid( _  
   ByRef Target As String, _  
   ByVal Start As Integer, _  
   Optional ByVal Length As Integer _  
) = StringExpression  

Partes

Target
Obrigatório. Nome da String variável a ser modificada.

Start
Obrigatório. Integer expressão. Posição do caractere em Target que a substituição do texto começa. Start usa um índice baseado em um.

Length
Opcional. Integer expressão. Número de caracteres a substituir. Se omitido, tudo String é usado.

StringExpression
Obrigatório. String expressão que substitui parte do Target.

Exceções

Tipo de exceção Condição
ArgumentException Start<= 0 ou Length< 0.

Observações

O número de caracteres substituídos é sempre menor ou igual ao número de caracteres no Target.

Visual Basic tem uma Mid função e uma Mid instrução. Esses elementos operam em um número especificado de caracteres em uma cadeia de caracteres, mas a Mid função retorna os caracteres enquanto a Mid instrução substitui os caracteres. Para obter mais informações, veja Mid.

Nota

A MidB instrução de versões anteriores do Visual Basic substitui uma substring em bytes, em vez de caracteres. Ele é usado principalmente para converter cadeias de caracteres em aplicativos DBCS (conjunto de caracteres de byte duplo). Todas as cadeias de caracteres do Visual Basic estão em Unicode e MidB não há mais suporte.

Exemplo

Este exemplo usa a Mid instrução para substituir um número especificado de caracteres em uma variável de cadeia de caracteres por caracteres de outra cadeia de caracteres.

Dim testString As String
' Initializes string.
testString = "The dog jumps"
' Returns "The fox jumps".
Mid(testString, 5, 3) = "fox"
' Returns "The cow jumps".
Mid(testString, 5) = "cow"
' Returns "The cow jumpe".
Mid(testString, 5) = "cow jumped over"
' Returns "The duc jumpe".
Mid(testString, 5, 3) = "duck"

Requisitos

Espaço de nome:Microsoft.VisualBasic

Módulo:Strings

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

Consulte também