Propriedade NamedRange.Item

Artigo
01/09/2014

Obtém Microsoft.Office.Interop.Excel.Range que representa um intervalo em um deslocamento ao controle de NamedRange .

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

Sintaxe

'Declaração
ReadOnly Property Item As NamedRange_ItemType

NamedRange_ItemType Item { get; }

Valor de propriedade

Tipo: Microsoft.Office.Tools.Excel.NamedRange_ItemType
Microsoft.Office.Interop.Excel.Range que representa um intervalo em um deslocamento ao controle de NamedRange .

Comentários

A propriedade de Item destina-se a ser usada com os seguintes parâmetros.

Parâmetro	Descrição
RowIndex	O número de índice da célula que você deseja acessar a esquerda para a direita, em ordem. NamedRange.Item(1) retorna a célula superior esquerdo do intervalo; NamedRange.Item(2) retorna imediatamente a célula à direita da célula superior esquerdo.
ColumnIndex	Um número ou cadeia de caracteres que indica o número da coluna da célula você deseja acessar, começando com 1 ou “A” para a primeira coluna no intervalo.

Se você tentar usar Item sem especificar quaisquer parâmetros, Item obterá um objeto de NamedRange_ItemType que é parte da infraestrutura do Visual Studio e não destina-se a ser usado diretamente do seu código.

Os argumentos de RowIndex e de ColumnIndex são deslocamentos relacionados. Ou seja especificando RowIndex de 1 retorna células na primeira linha do intervalo, não a primeira linha da planilha.

Exemplos

O exemplo de código a seguir cria NamedRange e usar a propriedade de Item para selecione a célula que é deslocada de NamedRange por três colunas e por três linhas.

Esta é uma versão para personalização de um documento nível.

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

Esta versão é para um suplemento ao aplicativo.

Segurança do .NET Framework

Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiável.

Consulte também

Referência

NamedRange Interface

Namespace Microsoft.Office.Tools.Excel

Compartilhar via