ITextEdit.Replace-Methode (Span, String)

Ersetzt eine Folge von Zeichen durch einen anderen Text.

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 Boolean

bool Replace(
    Span replaceSpan,
    string replaceWith
)

bool Replace(
    Span replaceSpan, 
    String^ replaceWith
)

abstract Replace : 
        replaceSpan:Span * 
        replaceWith:string -> bool

function Replace(
    replaceSpan : Span, 
    replaceWith : String
) : boolean

Parameter

• replaceSpan
  Typ: Microsoft.VisualStudio.Text.Span

  Die Spanne der zu ersetzenden Zeichen.

• replaceWith
  Typ: String

  Der neue Text.

Rückgabewert

Typ: Boolean
true , wenn das Ersetzen erfolgreich war; false, wenn der Vorgang von einem schreibgeschützten Bereich verhindert wurde.

Ausnahmen

Ausnahme	Bedingung
ArgumentNullException	replaceWith ist NULL.
InvalidOperationException	Apply oder Cancel oder Dispose-Methode ist bereits für dieses Objekt aufgerufen.
ArgumentOutOfRangeException	replaceSpan.End ist größer als die Länge des Puffers.

Hinweise

Diese Methode hat die gleichen Auswirkungen wie das Löschen der Zeichen in replaceSpan und das anschließende Einfügen von replaceWith.

Das Ersetzen einer leeren Spanne mit einer leeren Zeichenfolge erfolgreich ausgeführt, aber keine neue Momentaufnahme generiert und löst ein Changed-Ereignis aus.

.NET Framework-Sicherheit

• Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.

Siehe auch

Referenz

ITextEdit Schnittstelle

Replace-Überladung

Microsoft.VisualStudio.Text-Namespace