Proprietà NamedRange.Item

Articolo
08/11/2011

Ottiene un oggetto Microsoft.Office.Interop.Excel.Range che rappresenta un intervallo in corrispondenza di un offset al controllo NamedRange.

Spazio dei nomi: Microsoft.Office.Tools.Excel
Assembly: Microsoft.Office.Tools.Excel (in Microsoft.Office.Tools.Excel.dll)

Sintassi

'Dichiarazione
ReadOnly Property Item As NamedRange_ItemType
    Get

NamedRange_ItemType Item { get; }

Valore proprietà

Tipo: Microsoft.Office.Tools.Excel.NamedRange_ItemType
Oggetto Microsoft.Office.Interop.Excel.Range che rappresenta un intervallo in corrispondenza di un offset al controllo NamedRange.

Note

La proprietà Item deve essere utilizzata con i parametri riportati di seguito.

Parametro	Oggetto di descrizione
RowIndex	Numero di indice della cella a cui si desidera accedere, nell'ordine da sinistra verso destra. NamedRange.Item(1) restituisce la cella superiore sinistra nell'intervallo; NamedRange.Item(2) restituisce immediatamente la cella a destra della cella superiore sinistra.
ColumnIndex	Numero o stringa che indica il numero di colonna della cella a cui si desidera accedere, a partire da 1 o "A" per la prima colonna dell'intervallo.

Se si tenta di utilizzare Item senza specificare alcun parametro, Item otterrà un oggetto NamedRange_ItemType che fa parte dell'infrastruttura di Visual Studio e non può essere utilizzato direttamente dal codice.

Gli argomenti RowIndex e ColumnIndex sono offset relativi. In altre parole, se si imposta l'argomento RowIndex su 1, verranno restituite le celle nella prima riga dell'intervallo, non quelle della prima riga del foglio di lavoro.

Esempi

Nell'esempio di codice riportato di seguito viene creato un controllo NamedRange. Viene quindi utilizzata la proprietà Item per selezionare la cella spostata di tre colonne e tre righe rispetto al controllo NamedRange.

Questa versione è valida per una personalizzazione a livello di documento.

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();
}

Questa versione è valida per un componente aggiuntivo a livello di applicazione.

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();
}

Sicurezza di .NET Framework

Attendibilità totale per il chiamante immediato. Impossibile utilizzare questo membro in codice parzialmente attendibile. Per ulteriori informazioni, vedere Utilizzo di librerie da codice parzialmente attendibile.

Vedere anche

Riferimenti

NamedRange Interfaccia

Spazio dei nomi Microsoft.Office.Tools.Excel

Share via