Freigeben über


NamedRange.MergeArea-Eigenschaft

Ruft einen Microsoft.Office.Interop.Excel.Range ab, der den zusammengeführten Bereich darstellt, der das NamedRange-Steuerelement enthält.

Namespace:  Microsoft.Office.Tools.Excel
Assembly:  Microsoft.Office.Tools.Excel (in Microsoft.Office.Tools.Excel.dll)

Syntax

'Declaration
ReadOnly Property MergeArea As Range
Range MergeArea { get; }

Eigenschaftswert

Typ: Microsoft.Office.Interop.Excel.Range
Ein Microsoft.Office.Interop.Excel.Range, der den zusammengeführten Bereich darstellt, der das NamedRange-Steuerelement enthält.Wenn sich das NamedRange-Steuerelement nicht in einem zusammengeführten Bereich befindet, gibt diese Eigenschaft einen Microsoft.Office.Interop.Excel.Range zurück, der das NamedRange-Steuerelement darstellt.

Hinweise

Die MergeArea-Eigenschaft funktioniert nur im Bereich einer einzelnen Zelle.

Beispiele

Im folgenden Codebeispiel wird der Wert der MergeArea-Eigenschaft und der MergeCells-Eigenschaft eines NamedRange mit einer einzelnen Zelle angezeigt. Dabei werden die jeweiligen Werte vor und nach der Anwendung der Merge-Methode zum Zusammenführen eines NamedRange mit mehreren Zellen angezeigt, der den NamedRange mit einer einzelnen Zelle enthält.

Dieses Beispiel bezieht sich auf eine Anpassung auf Dokumentebene.

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

        Dim namedRange2 As Microsoft.Office.Tools.Excel.NamedRange _
            = Me.Controls.AddNamedRange(Me.Range("A1"), "namedRange2")

        Dim beforeMergeAddress As String = _
            namedRange2.MergeArea.Address(, , _
            Excel.XlReferenceStyle.xlA1, , )

        MessageBox.Show("Before merging, the MergeArea property is '" & _
            beforeMergeAddress & "' and the MergeCells property is " & _
            " '" & namedRange2.MergeCells.ToString() & "'.")

        namedRange1.Select()
        namedRange1.Merge(False)

        Dim afterMergeAddress As String = _
            namedRange2.MergeArea.Address(, , _
            Excel.XlReferenceStyle.xlA1, , )

        MessageBox.Show("After merging, the MergeArea property is '" & _
            afterMergeAddress & "' and the MergeCells property is " & _
            " '" & namedRange2.MergeCells.ToString() & "'.")
    End Sub

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

    Microsoft.Office.Tools.Excel.NamedRange namedRange2 =
        this.Controls.AddNamedRange(this.Range["A1"],
        "namedRange2");

    string beforeMergeAddress = namedRange2.MergeArea.get_Address(
        Excel.XlReferenceStyle.xlA1);

    MessageBox.Show("Before merging, the MergeArea property is '" +
        beforeMergeAddress + "' and the MergeCells property is " +
        " '" + namedRange2.MergeCells.ToString() + "'.");

    namedRange1.Select();
    namedRange1.Merge(false);

    string afterMergeAddress = namedRange2.MergeArea.get_Address(
        Excel.XlReferenceStyle.xlA1);

    MessageBox.Show("After merging, the MergeArea property is '" +
        afterMergeAddress + "' and the MergeCells property is " +
        " '" + namedRange2.MergeCells.ToString() + "'.");
}

.NET Framework-Sicherheit

Siehe auch

Referenz

NamedRange Schnittstelle

Microsoft.Office.Tools.Excel-Namespace