Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
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: Int32The buffer position at which the first character of the text will appear.
text
Type: StringThe 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
- 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.