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

参数

  • startPosition
    类型:Int32

    开始替换的缓冲区位置。

  • charsToReplace
    类型:Int32

    要替换的字符数。

  • replaceWith
    类型:String

    新文本。

返回值

类型:Boolean
如果替换成功,则为 true;如果替换被只读区域阻止,则为 false。

异常

异常 条件
ArgumentNullException

replaceWith 为 null。

InvalidOperationException

ApplyCancelDispose 方法之前对该对象。

ArgumentOutOfRangeException

startPosition 大于零的小于或大于缓冲区的长度,或者 charsToReplace 小于零,或 startPosition + charsToReplace 大于缓冲区的长度。

备注

此方法与先删除 charsToReplace 再插入 replaceWith 的效果相同。

替换字符用空字符串将会成功,而不会生成一个新的快照也不会引发 Changed 事件。

.NET Framework 安全性

请参阅

参考

ITextEdit 接口

Replace 重载

Microsoft.VisualStudio.Text 命名空间