NamedRange.Consolidate メソッド

複数のワークシート上の複数の範囲のデータを NamedRange コントロールに統合します。

名前空間:  Microsoft.Office.Tools.Excel
アセンブリ:  Microsoft.Office.Tools.Excel (Microsoft.Office.Tools.Excel.dll 内)

構文

'宣言
Function Consolidate ( _
    Sources As Object, _
    Function As Object, _
    TopRow As Object, _
    LeftColumn As Object, _
    CreateLinks As Object _
) As Object
Object Consolidate(
    Object Sources,
    Object Function,
    Object TopRow,
    Object LeftColumn,
    Object CreateLinks
)

パラメーター

  • Sources
    型 : System.Object
    統合元です。R1C1 スタイルの表記のテキスト参照文字列の配列で表します。参照には、統合するシートの完全パスを含める必要があります。
  • 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"],
        "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);
}

.NET Framework セキュリティ

  • 直前の呼び出し元に対する完全な信頼。このメンバーは、部分的に信頼されているコードから使用することはできません。詳細については、「部分信頼コードからのライブラリの使用」を参照してください。

参照

関連項目

NamedRange インターフェイス

Microsoft.Office.Tools.Excel 名前空間