Partager via


IProjectionBufferBase.Insert Method (Int32, String)

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

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

Syntax

'Déclaration
Function Insert ( _
    position As Integer, _
    text As String _
) As IProjectionSnapshot
IProjectionSnapshot Insert(
    int position,
    string text
)
IProjectionSnapshot^ Insert(
    int position, 
    String^ text
)
abstract Insert : 
        position:int * 
        text:string -> IProjectionSnapshot 
function Insert(
    position : int, 
    text : String
) : IProjectionSnapshot

Parameters

  • position
    Type: System.Int32
    The buffer position at which the first character of the text will appear.

Return Value

Type: Microsoft.VisualStudio.Text.Projection.IProjectionSnapshot
An IProjectionSnapshot.

Exceptions

Exception Condition
ArgumentNullException

text is nulla null reference (Nothing in Visual Basic).

ArgumentOutOfRangeException

position is less than zero or greater than the length of the buffer.

InvalidOperationException

A ITextEdit is currently active.

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

See Also

Reference

IProjectionBufferBase Interface

Insert Overload

Microsoft.VisualStudio.Text.Projection Namespace