IProjectionBufferBase::Replace Method (Span, String^)

Visual Studio 2015
 

Replaces a span of characters with different text. This is equivalent to first deleting the text to be replaced and then inserting the new text.

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

C#
C++
F#
VB
Copy 
IProjectionSnapshot^ Replace(
	Span replaceSpan,
	String^ replaceWith
)

Parameters

replaceSpan
Type: Microsoft.VisualStudio.Text::Span

The span of characters to replace.

replaceWith
Type: System::String^

The new text.

Return Value

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

An IProjectionSnapshot.

Exception Condition
ArgumentNullException

replaceWith is null.

ArgumentOutOfRangeException

The end of replaceSpan span is greater than the length of the buffer.

InvalidOperationException

A ITextEdit is currently active.

This is a shortcut for creating a new ITextEdit object, using it to replace the text, and then applying it. If the replacement 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 replacement.

Return to top
Show: