ITextEdit.Replace 方法 (Int32, Int32, String)

將一連串字元取代成不同的文字。

命名空間： Microsoft.VisualStudio.Text
組件： Microsoft.VisualStudio.Text.Data (在 Microsoft.VisualStudio.Text.Data.dll 中)

語法

'宣告
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

類型：Boolean
如果取代成功則為 true，如果遭到唯讀區域禁止則為 false。

例外狀況	條件
ArgumentNullException	replaceWith 為 null。
InvalidOperationException	Apply或Cancel或Dispose先前在此物件上呼叫方法。
ArgumentOutOfRangeException	startPosition小於零或大於緩衝區長度的，或charsToReplace小於零，或startPosition + charsToReplace大於緩衝區的長度。

這個方法的效果等同於先刪除 charsToReplace，然後再插入 replaceWith。

以空字串取代零字元會成功，但不是會產生新的快照集或引發Changed事件。