Partager via

ITextEdit.Insert Method (Int32, String)

  • Article

Inserts the given text at the specified positionin the text buffer.

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 Boolean

bool Insert(
    int position,
    string text
)

bool Insert(
    int position, 
    String^ text
)

abstract Insert : 
        position:int * 
        text:string -> bool

function Insert(
    position : int, 
    text : String
) : boolean

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: Boolean
true if the insertion succeeded, false if it failed due to a read-only region.

Exceptions

Exception Condition
ArgumentNullException

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

The Apply or Cancel or Dispose method has previously been called on this object.
ArgumentOutOfRangeException

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

Remarks

Inserting an empty string will succeed, but will not generate a new snapshot or raise a Changed event.

.NET Framework Security

See Also

Reference

ITextEdit Interface

Insert Overload

Microsoft.VisualStudio.Text Namespace