XmlMappedRange.Consolidate(Object, Object, Object, Object, Object) 方法
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
將多張工作表上多個範圍的資料合併到 XmlMappedRange 控制項中。
public object Consolidate (object Sources, object Function, object TopRow, object LeftColumn, object CreateLinks);abstract member Consolidate : obj * obj * obj * obj * obj -> objPublic Function Consolidate (Optional Sources As Object, Optional Function As Object, Optional TopRow As Object, Optional LeftColumn As Object, Optional CreateLinks As Object) As Object參數
- Sources
- Object
合併來源，為採用 R1C1 樣式標記的文字參照字串陣列。 參照必須包括需要合併的工作表之完整路徑。
- Function
- Object
可以為下列 XlConsolidationFunction 其中一個常數： xlAveragexlCountxlCountNumsxlMaxxlMinxlProductxlStDevxlStDevPxlSumxlVarxlVarP
- TopRow
- Object
true 表示根據合併範圍中頂端列的欄標題合併資料，否則為 false，表示依位置合併資料。 預設值是 false。
- LeftColumn
- Object
true 表示根據合併範圍中最左欄的列標題合併資料，否則為 false 表示依位置合併資料。 預設值是 false。
- CreateLinks
- Object
true 表示合併時使用工作表連結，否則為 false，表示合併時會複製資料。 預設值是 false。
傳回
範例
下列程式代碼範例會 Consolidate 使用 方法，將上的 Sheet2 A1 單元格值和上的 A1 Sheet3 儲存格合併為 XmlMappedRange 上的 Sheet1。 此範例會藉由將值加在一起來合併值。 這個程式代碼範例假設 Sheet1 包含 XmlMappedRange 具名 CustomerLastNameCell的 。
private void ConsolidateCells()
{
Globals.Sheet2.Range["A1"].Value2 = 1710;
Globals.Sheet3.Range["A1"].Value2 = 1240;
string[] source = new string[] { "Sheet2!R1C1", "Sheet3!R1C1" };
Globals.Sheet1.CustomerAddress1Cell.Consolidate(source,
Excel.XlConsolidationFunction.xlSum,
false, false, false);
}
Private Sub ConsolidateCells()
Globals.Sheet2.Range("A1").Value2 = 1710
Globals.Sheet3.Range("A1").Value2 = 1240
Dim Source As String() = {"Sheet2!R1C1", "Sheet3!R1C1"}
Globals.Sheet1.CustomerAddress1Cell.Consolidate(Source, _
Excel.XlConsolidationFunction.xlSum, False, False, False)
End Sub
備註
選擇性參數
如需選擇性參數的資訊，請參閱 Office 方案中的選擇性參數。