XmlMappedRange.Consolidate Метод (2007 System)

Статья
11/16/2008

Обновлен: Ноябрь 2007

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

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

Синтаксис

'Декларация
Public Function Consolidate ( _
    Sources As Object, _
    Function As Object, _
    TopRow As Object, _
    LeftColumn As Object, _
    CreateLinks As Object _
) As Object
'Применение
Dim instance As XmlMappedRange
Dim Sources As Object
Dim Function As Object
Dim TopRow As Object
Dim LeftColumn As Object
Dim CreateLinks As Object
Dim returnValue As Object

returnValue = instance.Consolidate(Sources, _
    Function, TopRow, LeftColumn, CreateLinks)

public 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);
}

Разрешения

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