NamedRange.Consolidate(Object, Object, Object, Object, Object) Metode
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Mengonsolidasikan data dari beberapa rentang pada beberapa lembar kerja ke NamedRange dalam kontrol.
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
Parameter
- Sources
- Object
Sumber konsolidasi sebagai array string referensi teks dalam notasi gaya R1C1. Referensi harus menyertakan jalur lengkap lembar yang akan dikonsolidasikan.
- Function
- Object
Bisa menjadi salah satu konstanta berikut XlConsolidationFunction : xlAveragexlCountxlCountNumsxlMaxxlMinxlProductxlStDevxlStDevPxlSumxlVarxlVarP
- TopRow
- Object
true
untuk mengonsolidasikan data berdasarkan judul kolom di baris atas rentang konsolidasi; false
untuk mengonsolidasikan data berdasarkan posisi. Nilai defaultnya adalah false
.
- LeftColumn
- Object
true
untuk mengonsolidasikan data berdasarkan judul baris di kolom kiri rentang konsolidasi; false
untuk mengonsolidasikan data berdasarkan posisi. Nilai defaultnya adalah false
.
- CreateLinks
- Object
true
agar konsolidasi menggunakan tautan lembar kerja; false
agar konsolidasi menyalin data. Nilai defaultnya adalah false
.
Mengembalikan
Contoh
Contoh kode berikut mengatur rentang sel dari B1 hingga D10 ke angka acak lalu menggunakan metode untuk mengonsolidasikan Consolidate rentang ini ke dalam NamedRange kontrol.
Contoh ini untuk kustomisasi tingkat dokumen.
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
Keterangan
Parameter Opsional
Untuk informasi tentang parameter opsional, lihat Parameter Opsional di Solusi Office.