NamedRange.Address-Eigenschaft
Ruft den Bereichsbezug für das NamedRange-Steuerelement ab.
Namespace: Microsoft.Office.Tools.Excel
Assembly: Microsoft.Office.Tools.Excel (in Microsoft.Office.Tools.Excel.dll)
Syntax
'Declaration
ReadOnly Property Address As NamedRange_AddressType
NamedRange_AddressType Address { get; }
Eigenschaftswert
Typ: Microsoft.Office.Tools.Excel.NamedRange_AddressType
Eine Zeichenfolge, die den Bereichsbezug des NamedRange-Steuerelements in Z1S1- oder A1-Notation darstellt.
Hinweise
Die Address-Eigenschaft ist für die Verwendung mit den folgenden Parametern vorgesehen.
Parameter |
Beschreibung |
---|---|
RowAbsolute |
true, wenn die Zeile als absoluter Bezug zurückgegeben werden soll.Der Standardwert ist true. |
ColumnAbsolute |
true, wenn die Spalte als absoluter Bezug zurückgegeben werden soll.Der Standardwert ist true. |
ColumnAbsolute |
Einer der XlReferenceStyle-Werte. |
External |
true, wenn ein externer Bezug zurückgegeben werden soll; false, wenn ein lokaler Bezug zurückgegeben werden soll.Der Standardwert ist false. |
RelativeTo |
Ein Range, der den Ausgangspunkt definiert.Wenn RowAbsolute und ColumnAbsolute den Wert false haben und ReferenceStyle den Wert xlR1C1 aufweist, müssen Sie einen Ausgangspunkt für den relativen Bezug einfügen. |
Wenn Sie versuchen, Address zu verwenden, ohne Parameter anzugeben, ruft Address ein NamedRange_AddressType-Objekt ab, das Teil der Visual Studio-Infrastruktur ist und nicht für die direkte Verwendung im Code vorgesehen ist.
Wenn der Bezug mehr als eine Zelle enthält, gelten RowAbsolute und ColumnAbsolute für alle Zeilen und Spalten.
Optionale Parameter
Informationen zu optionalen Parametern finden Sie unter Optionale Parameter in Office-Lösungen.
Beispiele
Im folgenden Codebeispiel wird ein NamedRange erstellt. Anschließend wird die Adresse des NamedRange in vier Formaten angezeigt.
Diese Version bezieht sich auf eine Anpassung auf Dokumentebene.
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
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]]);
}
Diese Version bezieht sich auf ein Add-In auf Anwendungsebene.
.NET Framework-Sicherheit
- Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.