NamedRange.Item, propriété

Obtient un Microsoft.Office.Interop.Excel.Range qui représente une plage à un offset du contrôle NamedRange.

Espace de noms :  Microsoft.Office.Tools.Excel
Assembly :  Microsoft.Office.Tools.Excel (dans Microsoft.Office.Tools.Excel.dll)

Syntaxe

'Déclaration
ReadOnly Property Item As NamedRange_ItemType
NamedRange_ItemType Item { get; }

Valeur de propriété

Type : Microsoft.Office.Tools.Excel.NamedRange_ItemType
Microsoft.Office.Interop.Excel.Range qui représente une plage à un offset du contrôle NamedRange.

Notes

La propriété Item doit être utilisée avec les paramètres suivants.

Paramètre

Description

RowIndex

Numéro d'index de la cellule à laquelle vous souhaitez accéder, en partant de la gauche.NamedRange.Item(1) retourne la cellule supérieure gauche dans la plage ; NamedRange.Item(2) retourne la cellule immédiatement à droite de la cellule supérieure gauche.

ColumnIndex

Nombre ou chaîne qui indique le numéro de colonne de la cellule à laquelle vous souhaitez accéder, en commençant par 1 ou A pour la première colonne de la plage.

Si vous essayez d'utiliser Item sans spécifier de paramètres, Item obtiendra un objet NamedRange_ItemType qui fait partie de l'infrastructure Visual Studio et n'est pas conçu pour être utilisé directement à partir de votre code.

Les arguments RowIndex et ColumnIndex sont des offsets relatifs.En d'autres termes, spécifier la valeur 1 pour RowIndex retourne des cellules dans la première ligne de la plage et non dans la première ligne de la feuille de calcul.

Exemples

L'exemple de code suivant crée un NamedRange, puis utilise la propriété Item pour sélectionner la cellule présentant un offset de trois colonnes et de trois lignes par rapport à NamedRange.

Cette version est destinée à une personnalisation au niveau du document.

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"], "itemRange");
    itemRange.Value2 = "NamedRange";
    Excel.Range offsetCell =
        (Excel.Range)this.itemRange.Item[3, 3];
    offsetCell.Value2 = "Offset cell.";
    offsetCell.Select();
}

Cette version est destinée à un complément d'application.

Sécurité .NET Framework

Voir aussi

Référence

NamedRange Interface

Microsoft.Office.Tools.Excel, espace de noms