NamedRange.Consolidate(Object, Object, Object, Object, Object) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Консолидирует данные из нескольких диапазонов на нескольких листах в элементе управления 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
.
Возвращаемое значение
Примеры
В следующем примере кода задается диапазон ячеек от 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.