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

Статья
11/16/2008

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

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

Пространство имен: 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 NamedRange
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.

Примеры

В следующем примере кода диапазону ячеек от B1 до D10 присваиваются случайные числа, после чего с помощью метода Consolidate выполняется консолидация этого диапазона в элементе управления NamedRange.

В этом примере демонстрируется настройка уровня документа.

Private Sub SetConsolidation()
    Dim namedRange1 As Microsoft.Office.Tools.Excel.NamedRange _
        = Me.Controls.AddNamedRange(Me.Range("A1"), _
        "namedRange1")

    Dim Range1 As Excel.Range = Me.Range("B1", "D10")
    Range1.Formula = "=rand()"

    Dim [source]() As String = {"Sheet1!R1C2:R10C4"}
    namedRange1.Consolidate([source], _
    Excel.XlConsolidationFunction.xlSum, False, False, False)

End Sub

private void SetConsolidation()
{
    Microsoft.Office.Tools.Excel.NamedRange namedRange1 =
        this.Controls.AddNamedRange(this.Range["A1", missing],
        "namedRange1");

    Excel.Range Range1 = this.Range["B1", "D10"];
    Range1.Formula = "=rand()";

    string[] source = new string[] { "Sheet1!R1C2:R10C4" };
    namedRange1.Consolidate(source, Excel.XlConsolidationFunction.xlSum,
        false, false, false);
}

Разрешения

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