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: Int32Die Pufferposition, an der mit dem Ersetzen begonnen werden soll.
charsToReplace
Typ: Int32Die Anzahl der zu ersetzenden Zeichen.
replaceWith
Typ: StringDer 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
- 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.