ITextBuffer.Insert Method

Inserts the given text at the specified position in the ITextBuffer.

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

Syntax

'Declaration
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

Parameters

• position
  Type: Int32

  The buffer position at which the first character of the text will appear.

• text
  Type: String

  The text to be inserted.

Return Value

Type: Microsoft.VisualStudio.Text.ITextSnapshot
The ITextSnapshot.

Exceptions

Exception	Condition
ArgumentNullException	text is nulla null reference (Nothing in Visual Basic).
InvalidOperationException	A text edit is currently active.
ArgumentOutOfRangeException	position is less than zero or greater than the length of the buffer.

Remarks

This is a shortcut for creating a new ITextEdit object, using it to insert the text, and then applying it. If the insertion fails on account of a read-only region, the snapshot returned will be the same as the current snapshot of the buffer before the attempted insertion.

.NET Framework Security

• Full trust for the immediate caller. This member cannot be used by partially trusted code. For more information, see Using Libraries from Partially Trusted Code.

See Also

Reference

ITextBuffer Interface

Microsoft.VisualStudio.Text Namespace