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

Определение

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

Microsoft.Office.Tools.Excel

Сборка:

Microsoft.Office.Tools.Excel.dll

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

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

Примеры

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

Этот пример предназначен для настройки на уровне документа.

private void SetConsolidation()
{
    Microsoft.Office.Tools.Excel.NamedRange namedRange1 =
        this.Controls.AddNamedRange(this.Range["A1"],
        "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);
}

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

Комментарии

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

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