Freigeben über


ITextEdit.Replace-Methode (Int32, Int32, 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 ( _
    startPosition As Integer, _
    charsToReplace As Integer, _
    replaceWith As String _
) As Boolean
bool Replace(
    int startPosition,
    int charsToReplace,
    string replaceWith
)
bool Replace(
    int startPosition, 
    int charsToReplace, 
    String^ replaceWith
)
abstract Replace : 
        startPosition:int * 
        charsToReplace:int * 
        replaceWith:string -> bool
function Replace(
    startPosition : int, 
    charsToReplace : int, 
    replaceWith : String
) : boolean

Parameter

  • startPosition
    Typ: Int32

    Die Pufferposition, an der mit dem Ersetzen begonnen werden soll.

  • charsToReplace
    Typ: Int32

    Die Anzahl 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

startPosition ist kleiner als Null oder größer als die Länge des Puffers, oder charsToReplace ist kleiner als Null oder startPosition + charsToReplace ist größer als die Länge des Puffers.

Hinweise

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

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

.NET Framework-Sicherheit

Siehe auch

Referenz

ITextEdit Schnittstelle

Replace-Überladung

Microsoft.VisualStudio.Text-Namespace