NamedRange.Item 속성

NamedRange 컨트롤에 대한 오프셋의 범위를 나타내는 Microsoft.Office.Interop.Excel.Range를 가져옵니다.

네임스페이스:  Microsoft.Office.Tools.Excel
어셈블리:  Microsoft.Office.Tools.Excel(Microsoft.Office.Tools.Excel.dll)

구문

‘선언
ReadOnly Property Item As NamedRange_ItemType
    Get

NamedRange_ItemType Item { get; }

속성 값

형식: Microsoft.Office.Tools.Excel.NamedRange_ItemType
NamedRange 컨트롤에 대한 오프셋의 범위를 나타내는 Microsoft.Office.Interop.Excel.Range입니다.

설명

Item 속성은 다음 매개 변수와 함께 사용할 수 있습니다.

Parameter	설명
RowIndex	액세스하려는 셀의 인덱스 번호로, 순서는 왼쪽에서 오른쪽입니다. NamedRange.Item(1)은 범위의 왼쪽 위 셀을 반환합니다. NamedRange.Item(2)은 왼쪽 위 셀의 바로 오른쪽 셀을 반환합니다.
ColumnIndex	액세스하려는 셀의 열 번호를 나타내는 번호나 문자열이며, 범위의 첫째 열의 경우 1 또는 "A"로 시작합니다.

매개 변수를 지정하지 않고 Item을 사용하려고 하면 Item은 Visual Studio 인프라에 속하며 사용자 코드에서 직접 사용할 수 없는 NamedRange_ItemType 개체를 가져옵니다.

RowIndex 및 ColumnIndex 인수는 상대적 오프셋입니다. 즉, RowIndex를 1로 지정하면 워크시트의 첫째 행이 아닌 범위의 첫째 행에 포함된 셀이 반환됩니다.

예제

다음 코드 예제에서는 NamedRange를 만든 다음 Item 속성을 사용하여 NamedRange를 기준으로 세 개의 열과 세 개의 행만큼 오프셋된 셀을 선택합니다.

이 버전은 문서 수준 사용자 지정을 위한 것입니다.

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

이 버전은 응용 프로그램 수준 추가 기능을 위한 것입니다.

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 보안

• 직접 실행 호출자의 경우 완전히 신뢰합니다. 이 멤버는 부분적으로 신뢰할 수 있는 코드에서 사용할 수 없습니다. 자세한 내용은 부분 신뢰 코드에서 라이브러리 사용을 참조하십시오.

참고 항목

참조

NamedRange 인터페이스

Microsoft.Office.Tools.Excel 네임스페이스