Compartilhar via


Método ITextBuffer.Insert

Insere a determinado text no local especificado position na ITextBuffer.

Namespace:  Microsoft.VisualStudio.Text
Assembly:  Microsoft.VisualStudio.Text.Data (em Microsoft.VisualStudio.Text.Data.dll)

Sintaxe

'Declaração
Function Insert ( _
    position As Integer, _
    text As String _
) As ITextSnapshot
ITextSnapshot Insert(
    int position,
    string text
)
ITextSnapshot^ Insert(
    int position, 
    String^ text
)
abstract Insert : 
        position:int * 
        text:string -> ITextSnapshot
function Insert(
    position : int, 
    text : String
) : ITextSnapshot

Parâmetros

  • position
    Tipo: Int32

    A posição do buffer no qual o primeiro caractere do texto será exibido.

  • text
    Tipo: String

    O texto a ser inserido.

Valor de retorno

Tipo: Microsoft.VisualStudio.Text.ITextSnapshot
O ITextSnapshot.

Exceções

Exceção Condição
ArgumentNullException

text é nulluma referência nula (Nothing no Visual Basic).

InvalidOperationException

Uma edição de texto está ativa.

ArgumentOutOfRangeException

positioné menor que zero ou maior que o comprimento do buffer.

Comentários

Este é um atalho para a criação de uma nova ITextEdit objeto, usando-o para inserir o texto e depois aplicá-la. Se a inserção falhar por conta de uma região de somente leitura, o instantâneo retornado será o mesmo que o instantâneo atual do buffer antes da inserção de tentativa.

Segurança do .NET Framework

Consulte também

Referência

ITextBuffer Interface

Namespace Microsoft.VisualStudio.Text