Propriedade NamedRange.Item

Artigo
08/01/2011

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

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
    Get

NamedRange_ItemType Item { get; }

Valor de propriedade

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

Comentários

O Item propriedade destina-se a ser usado com os seguintes parâmetros.

Parameter	Description
RowIndex	O número de índice da célula que você deseja acessar, na ordem da esquerda para a direita. NamedRange.Item(1)Retorna a célula superior esquerda do intervalo; NamedRange.Item(2)Retorna a célula imediatamente à direita da célula superior esquerda.
ColumnIndex	Um número ou cadeia de caracteres que indica o número da coluna da célula que você deseja acessar, começando com 1 ou "Um" para a primeira coluna no intervalo.

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

O RowIndex e ColumnIndex argumentos são deslocamentos relativos. Em outras palavras, especificando um RowIndex de 1 retorna as células na primeira linha do intervalo, não a primeira linha da planilha.

Exemplos

O exemplo de código a seguir cria um NamedRange e, em seguida, usa o Item propriedade para selecionar a célula que é deslocada a partir de NamedRange por três colunas e linhas três.

Esta versão é para uma personalização em nível de 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();
}

Esta versão é um suplemento em nível de aplicativo.

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

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

Consulte também

Referência

NamedRange Interface

Namespace Microsoft.Office.Tools.Excel

Compartilhar via