XmlMappedRange.Replace 方法
以新的字串取代 XmlMappedRange 控制項中指定的字元。
命名空間： Microsoft.Office.Tools.Excel
組件： Microsoft.Office.Tools.Excel (在 Microsoft.Office.Tools.Excel.dll 中)
語法
'宣告
Function Replace ( _
What As Object, _
Replacement As Object, _
LookAt As Object, _
SearchOrder As Object, _
MatchCase As Object, _
MatchByte As Object, _
SearchFormat As Object, _
ReplaceFormat As Object _
) As Boolean
bool Replace(
Object What,
Object Replacement,
Object LookAt,
Object SearchOrder,
Object MatchCase,
Object MatchByte,
Object SearchFormat,
Object ReplaceFormat
)
參數
- What
型別：System.Object
要 Microsoft Office Excel 搜尋的字串。
- Replacement
型別：System.Object
取代字串。
- LookAt
型別：System.Object
可以是下列其中一個 XlLookAt 常數：xlWhole 或 xlPart。
- SearchOrder
型別：System.Object
可以是下列其中一個 XlSearchOrder 常數：xlByRows 或 xlByColumns。
- MatchCase
型別：System.Object
true 表示搜尋時區分大小寫。
- MatchByte
型別：System.Object
只有當您在 Excel 中選取或安裝雙位元語言支援時，才能使用這個引數。true 表示只會將雙位元組字元與雙位元組字元比對，否則為 false，表示將雙位元組字元與其對等的單位元組字元比對。
- SearchFormat
型別：System.Object
方法的搜尋格式。
- ReplaceFormat
型別：System.Object
方法的取代格式。
傳回值
型別：System.Boolean
如果指定的字元在 XmlMappedRange 控制項中，此值為 true，否則為 false。
備註
使用這個方法不會變更選取範圍或現用儲存格。
每次使用這個方法時，會儲存 LookAt、SearchOrder、MatchCase 和 MatchByte 的設定。 如果沒有為這些引數指定值，下次您呼叫這個方法時便會使用已儲存的值。 設定這些引數會變更 [尋找] 對話方塊中的設定，而變更 [尋找] 對話方塊中的設定會變更您省略引數時使用的儲存值。 若要避免發生問題，每次使用這個方法時應明確設定這些引數。
選擇性參數
如需選擇性參數的詳細資訊，請參閱Office 方案中的選擇性參數。
範例
下列程式碼範例使用 Replace 方法，將 XmlMappedRange 內的字串 "Smith" 取代為字串 "Jones"。 這個程式碼範例假設目前工作表包含名為 CustomerLastNameCell 的 XmlMappedRange。
Private Sub ReplaceSmith()
Me.CustomerLastNameCell.Value2 = "Walker, Smith, James"
Me.CustomerLastNameCell.Replace("Smith", "Jones")
End Sub
private void ReplaceSmith()
{
this.CustomerLastNameCell.Value2 = "Walker, Smith, James";
this.CustomerLastNameCell.Replace("Smith", "Jones", missing,
missing, missing, missing, missing, missing);
}
.NET Framework 安全性
- 完全信任立即呼叫者。這個成員無法供部分信任的程式碼使用。如需詳細資訊，請參閱從部分受信任程式碼使用程式庫。