NamedRange.Address Eigenschaft

Definition

Ruft den Bereichsbezug für das NamedRange-Steuerelement ab.

public Microsoft.Office.Tools.Excel.NamedRange_AddressType Address { get; }

Eigenschaftswert

NamedRange_AddressType

Eine Zeichenfolge, die den Bereichsbezug des NamedRange-Steuerelements in Z1S1- oder A1-Notation darstellt.

Beispiele

Im folgenden Codebeispiel wird ein erstellt NamedRange und dann die Adresse des NamedRange in vier Formaten angezeigt.

Diese Version ist für eine Anpassung auf Dokument Ebene vorgesehen.

private void DisplayAddress()
{
    Microsoft.Office.Tools.Excel.NamedRange namedRange1 =
        this.Controls.AddNamedRange(this.Range["A2","C4"],
        "namedRange1");

    // The following code will display "$A$2:$C$4".
    MessageBox.Show(namedRange1.Address[true, true,
        Excel.XlReferenceStyle.xlA1, false]);

    // The following code will display "$A2:$C4".
    MessageBox.Show(namedRange1.Address[false, true,
        Excel.XlReferenceStyle.xlA1, false]);

    // The following code will display "R2C1:R4C3".
    MessageBox.Show(namedRange1.Address[true, true,
        Excel.XlReferenceStyle.xlR1C1, false]);

    // The following code will display "R[-1]C[-2]:R[1]C".
    MessageBox.Show(namedRange1.Address[false, false,
        Excel.XlReferenceStyle.xlR1C1, false, this.Cells[3, 3]]);
}
Private Sub DisplayAddress()
    Dim namedRange1 As Microsoft.Office.Tools.Excel.NamedRange _
        = Me.Controls.AddNamedRange(Me.Range("A2", "C4"), _
        "namedRange1")

    ' The following code will display "$A$2:$C$4".
    MessageBox.Show(namedRange1.Address(True, True, _
        Excel.XlReferenceStyle.xlA1, False, ))

    ' The following code will display "$A2:$C4".
    MessageBox.Show(namedRange1.Address(False, True, _
        Excel.XlReferenceStyle.xlA1, False, ))

    ' The following code will display "R2C1:R4C3".
    MessageBox.Show(namedRange1.Address(True, True, _
        Excel.XlReferenceStyle.xlR1C1, False, ))

    ' The following code will display "R[-1]C[-2]:R[1]C".
    MessageBox.Show(namedRange1.Address(False, False, _
        Excel.XlReferenceStyle.xlR1C1, False, Me.Cells(3, 3)))
End Sub

Diese Version ist für ein Add-in auf Anwendungsebene vorgesehen.

Hinweise

Die- Address Eigenschaft ist für die Verwendung mit den folgenden Parametern vorgesehen.

Parameter Beschreibung
RowAbsolute true, wenn die Zeile als absoluter Verweis zurückgegeben werden soll. Der Standardwert ist true.
ColumnAbsolute true, um die Spalte als absoluten Verweis zurückzugeben. Der Standardwert ist true.
ColumnAbsolute Einer der XlReferenceStyle-Werte.
External true, um einen externen Verweis zurückzugeben. false, um einen lokalen Verweis zurückzugeben. Der Standardwert ist false.
RelativeTo Ein Range , der den Anfangspunkt definiert. Wenn RowAbsolute und ColumnAbsolute sind false und ReferenceStyle ist xlR1C1 , müssen Sie einen Anfangspunkt für den relativen Verweis einschließen.

Wenn Sie versuchen, Address ohne Angabe von Parametern zu verwenden, erhält Address ein NamedRange_AddressType -Objekt, das Teil der Visual Studio-Infrastruktur ist und nicht für die direkte Verwendung im Code vorgesehen ist.

, Wenn der Verweis mehr als eine Zelle enthält RowAbsolute und ColumnAbsolute auf alle Zeilen und Spalten angewendet wird.

Optionale Parameter

Weitere Informationen zu optionalen Parametern finden Sie unter optionale Parameter in Office-Projektmappen.

Gilt für