XmlMappedRange.Consolidate - метод

Статья
08/11/2011

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

Пространство имен: Microsoft.Office.Tools.Excel
Сборка: Microsoft.Office.Tools.Excel (в Microsoft.Office.Tools.Excel.dll)

Синтаксис

'Декларация
Function Consolidate ( _
    Sources As Object, _
    Function As Object, _
    TopRow As Object, _
    LeftColumn As Object, _
    CreateLinks As Object _
) As Object

Object Consolidate(
    Object Sources,
    Object Function,
    Object TopRow,
    Object LeftColumn,
    Object CreateLinks
)

Параметры

Sources
Тип: System.Object
Источник консолидации как массив текстовых строк ссылок в нотации стиля R1C1.Ссылки должны включать полный путь для консолидируемых листов.

Function
Тип: System.Object
Может быть одна из следующих констант XlConsolidationFunction:
xlAverage
xlCount
xlCountNums
xlMax
xlMin
xlProduct
xlStDev
xlStDevP
xlSum
xlVar
xlVarP

TopRow
Тип: System.Object
true, чтобы консолидировать данные на основании заголовков столбцов в верхней строке консолидируемых диапазонов; false чтобы консолидировать данные по положению.Значение по умолчанию — false.

LeftColumn
Тип: System.Object
true, чтобы консолидировать данные на основании заголовков строк в левом столбце консолидируемых диапазонов; false чтобы консолидировать данные по положению.Значение по умолчанию — false.

CreateLinks
Тип: System.Object
true, чтобы консолидация использовала ссылки листов; false, чтобы консолидация копировала данные.Значение по умолчанию — false.

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

Тип: System.Object

Заметки

Необязательные параметры

Сведения о необязательных параметрах см. в разделе Необязательные параметры в решениях Office.

Примеры

В следующем примере кода метод Consolidate используется для консолидации значений ячейки A1 на Sheet2 и ячейки A1 на Sheet3 в XmlMappedRange на Sheet1. В примере значения консолидируются сложением всех значений. В этом примере предполагается, что Sheet1 содержит XmlMappedRange, именуемый CustomerLastNameCell.

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

private void ConsolidateCells()
{
    Globals.Sheet2.Range["A1", missing].Value2 = 1710;
    Globals.Sheet3.Range["A1", missing].Value2 = 1240;

    string[] source = new string[] { "Sheet2!R1C1", "Sheet3!R1C1" };
    Globals.Sheet1.CustomerAddress1Cell.Consolidate(source, 
        Excel.XlConsolidationFunction.xlSum,
        false, false, false);
}

Безопасность платформы .NET Framework

Полное доверие для непосредственно вызывающего метода. Этот член не может быть использован частично доверенным кодом. Дополнительные сведения см. в разделе Использование библиотек из не вполне надежного кода.

См. также

Ссылки

XmlMappedRange Интерфейс

Microsoft.Office.Tools.Excel - пространство имен

Поделиться через