XmlMappedRange.Consolidate(Object, Object, Object, Object, Object) Метод

Определение

Пространство имен:

Microsoft.Office.Tools.Excel

Сборка:

Microsoft.Office.Tools.Excel.dll

Консолидирует данные из нескольких диапазонов на нескольких листах в элементе управления XmlMappedRange.

public object Consolidate (object Sources, object Function, object TopRow, object LeftColumn, object CreateLinks);

abstract member Consolidate : obj * obj * obj * obj * obj -> obj

Public 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.

Возвращаемое значение

Object

Примеры

В следующем примере кода метод используется Consolidate для консолидации значений ячейки A1 в Sheet2 и ячейки A1 в Sheet3 .Sheet1XmlMappedRange В этом примере значения объединяются путем их объединения. В этом примере кода предполагается, что 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.