NamedRange.Item-Eigenschaft

Artikel
08/10/2011

Ruft einen Microsoft.Office.Interop.Excel.Range ab, der einen Bereich darstellt, der in Bezug auf das NamedRange-Steuerelement um einen bestimmten Offset versetzt ist.

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

Syntax

'Declaration
ReadOnly Property Item As NamedRange_ItemType
    Get

NamedRange_ItemType Item { get; }

Eigenschaftswert

Typ: Microsoft.Office.Tools.Excel.NamedRange_ItemType
Ein Microsoft.Office.Interop.Excel.Range, der einen Bereich darstellt, der in Bezug auf das NamedRange-Steuerelement um einen bestimmten Offset versetzt ist.

Hinweise

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

Parameter	Beschreibungen
RowIndex	Die Indexnummer der Zelle, auf die Sie zugreifen möchten, in der Reihenfolge von links nach rechts. NamedRange.Item(1) gibt die linke obere Zelle im Bereich zurück; NamedRange.Item(2) gibt die Zelle sofort rechts neben der linken oberen Zelle zurück.
ColumnIndex	Eine Zahl oder eine Zeichenfolge, die die Spaltennummer der Zelle angibt, auf die Sie zugreifen möchten. Dabei wird die erste Spalte in dem Bereich entweder mit 1 oder mit "A" bezeichnet.

Wenn Sie versuchen, Item zu verwenden, ohne Parameter anzugeben, ruft Item ein NamedRange_ItemType-Objekt ab, das Teil der Visual Studio-Infrastruktur ist und nicht für die direkte Verwendung im Code vorgesehen ist.

Das RowIndex-Argument und das ColumnIndex-Argument sind relative Offsets. D. h., wenn ein RowIndex mit 1 angegeben wird, werden die Zellen in der ersten Zeile des Bereichs zurückgegeben und nicht die erste Zeile des Arbeitsblatts.

Beispiele

Im folgenden Codebeispiel wird ein NamedRange erstellt. Anschließend wird mithilfe der Item-Eigenschaft die Zelle ausgewählt, die gegenüber einem NamedRange um drei Spalten und drei Zeilen versetzt ist.

Diese Version bezieht sich auf eine Anpassung auf Dokumentebene.

Private itemRange As Microsoft.Office.Tools.Excel.NamedRange

Private Sub SelectItem()
    itemRange = Me.Controls.AddNamedRange( _
        Me.Range("A1"), "itemRange")
    itemRange.Value2 = "NamedRange"
    Dim offsetCell As Excel.Range = _
        CType(Me.itemRange.Item(3, 3), Excel.Range)
    offsetCell.Value2 = "Offset cell."
    offsetCell.Select()
End Sub

Microsoft.Office.Tools.Excel.NamedRange itemRange;
private void SelectItem()
{
    itemRange = this.Controls.AddNamedRange(
        this.Range["A1", missing], "itemRange");
    itemRange.Value2 = "NamedRange";
    Excel.Range offsetCell =
        (Excel.Range)this.itemRange.Item[3, 3];
    offsetCell.Value2 = "Offset cell.";
    offsetCell.Select();
}

Diese Version bezieht sich auf ein Add-In auf Anwendungsebene.

Private itemRange As NamedRange

Private Sub SelectItem()

    Dim NativeWorksheet As Microsoft.Office.Interop.Excel.Worksheet =
        Globals.ThisAddIn.Application.ActiveSheet

    Dim vstoWorksheet As Microsoft.Office.Tools.Excel.Worksheet =
            Globals.Factory.GetVstoObject(NativeWorksheet)

    itemRange = vstoWorksheet.Controls.AddNamedRange( _
        vstoWorksheet.Range("A1"), "itemRange")
    itemRange.Value2 = "NamedRange"
    Dim offsetCell As Excel.Range = _
        CType(Me.itemRange.Item(3, 3), Excel.Range)
    offsetCell.Value2 = "Offset cell."
    offsetCell.Select()
End Sub

NamedRange itemRange;
private void SelectItem()
{
    Worksheet vstoWorksheet =
        Globals.Factory.GetVstoObject(this.Application.ActiveWorkbook.Worksheets[1]);
    itemRange = vstoWorksheet.Controls.AddNamedRange(
        vstoWorksheet.Range["A1", missing], "itemRange");
    itemRange.Value2 = "NamedRange";
    Excel.Range offsetCell =
        (Excel.Range)itemRange.Item[3, 3];
    offsetCell.Value2 = "Offset cell.";
    offsetCell.Select();
}

.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.

Siehe auch

Referenz

NamedRange Schnittstelle

Microsoft.Office.Tools.Excel-Namespace

Share via