Freigeben über


ITextBuffer.Replace-Methode

Ersetzt eine Folge von Zeichen durch einen anderen Text. Dies ist identisch damit, dass zunächst der zu ersetzende Texts gelöscht und dann der neue Text eingefügt wird.

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

Syntax

'Declaration
Function Replace ( _
    replaceSpan As Span, _
    replaceWith As String _
) As ITextSnapshot
ITextSnapshot Replace(
    Span replaceSpan,
    string replaceWith
)
ITextSnapshot^ Replace(
    Span replaceSpan, 
    String^ replaceWith
)
abstract Replace : 
        replaceSpan:Span * 
        replaceWith:string -> ITextSnapshot
function Replace(
    replaceSpan : Span, 
    replaceWith : String
) : ITextSnapshot

Parameter

  • replaceWith
    Typ: String

    Der neue Text, der den alten Text ersetzt.

Rückgabewert

Typ: Microsoft.VisualStudio.Text.ITextSnapshot
Der ITextSnapshot.

Ausnahmen

Ausnahme Bedingung
ArgumentNullException

replaceWith ist nullein Nullverweis (Nothing in Visual Basic).

InvalidOperationException

Eine Textbearbeitung ist gerade aktiv.

ArgumentOutOfRangeException

replaceSpan. End ist größer als die Länge des Puffers.

Hinweise

Dies ist eine Verknüpfung zum Erstellen eines neuen ITextEdit-Objekts, wobei es, um den Text anwenden und ihn dann zu ersetzen. Wenn die Ersetzung aufgrund eines schreibgeschützten Bereichs fehlschlägt, ist die zurückgegebene Momentaufnahme identisch mit der aktuellen Momentaufnahme eines Puffers vor der versuchten ein Ersatz.

.NET Framework-Sicherheit

Siehe auch

Referenz

ITextBuffer Schnittstelle

Microsoft.VisualStudio.Text-Namespace