방법: COM Interop 프로그래밍에서 인덱싱된 속성 사용(C# 프로그래밍 가이드)

아티클
08/09/2011

인덱싱된 속성은 C# 프로그래밍에서 매개 변수 있는 COM 속성이 사용되는 방식을 향상시킵니다. 인덱싱된 속성은 Visual C# 2010에서 도입된 명명된 인수 및 선택적 인수, 새로운 형식(dynamic), 포함된 형식 정보 등의 다른 기능과 함께 작동하여 Microsoft Office 프로그래밍을 향상시킵니다.

이전 버전의 C#에서는 get 메서드에 매개 변수가 없고 set 메서드의 매개 변수로 값 매개 변수 하나만 있는 경우에만 메서드를 속성으로 액세스할 수 있습니다. 그러나 모든 COM 속성이 이러한 제한 사항에 부합하는 것은 아닙니다. 예를 들어, Excel Range 속성에는 범위 이름에 대한 매개 변수가 필요한 get 접근자가 있습니다. 이전에는 Range 속성에 직접 액세스할 수 없었기 때문에 다음 예제와 같이 get_Range 메서드를 대신 사용해야 했습니다.

// Visual C# 2008 and earlier.
var excelApp = new Excel.Application();
// . . .
Excel.Range targetRange = excelApp.get_Range("A1", Type.Missing);

인덱싱된 속성을 사용하면 앞의 예제 대신 다음을 작성할 수 있습니다.

// Visual C# 2010.
var excelApp = new Excel.Application();
// . . .
Excel.Range targetRange = excelApp.Range["A1"];

참고

이전 예제에서는 Type.Missing을 생략할 수 있도록 Visual C# 2010에 도입된 선택적 인수라는 기능도 사용합니다.

마찬가지로, Visual C# 2008 및 이전 버전에서 Range 개체의 Value 속성 값을 설정하려면 인수 두 개가 필요합니다. 한 인수는 범위 값의 형식을 지정하는 선택적 매개 변수에 대한 값을 제공하고, 다른 인수는 Value 속성에 대한 값을 제공합니다. Visual C# 2010 이전 버전의 C# 에서는 인수 하나만 허용되었습니다. 따라서 일반적인 set 메서드를 사용하는 대신 set_Value 메서드를 사용하거나 다른 속성인 Value2를 사용해야 합니다. 다음 예제에서는 이 방법을 보여 줍니다. 두 예제에서는 모두 A1 셀의 값을 Name에 설정합니다.

// Visual C# 2008.
targetRange.set_Value(Type.Missing, "Name");
// Or
targetRange.Value2 = "Name";

인덱싱된 속성을 사용하면 앞의 예제 대신 다음 코드를 작성할 수 있습니다.

// Visual C# 2010.
targetRange.Value = "Name";

인덱싱된 속성을 직접 만들 수 없습니다. 이 기능으로는 기존의 인덱싱된 속성만 사용할 수 있습니다.

예제

다음 코드에서는 전체 예제를 보여 줍니다. Office API에 액세스하는 프로젝트를 설정하는 방법에 대한 자세한 내용은 방법: Visual C# 2010 기능을 사용하여 Office Interop 개체에 액세스(C# 프로그래밍 가이드)를 참조하십시오.

// You must add a reference to Microsoft.Office.Interop.Excel to run 
// this example.
using System;
using Excel = Microsoft.Office.Interop.Excel;

namespace IndexedProperties
{
    class Program
    {
        static void Main(string[] args)
        {
            CSharp2010();
            //CSharp2008();
        }

        static void CSharp2010()
        {
            var excelApp = new Excel.Application();
            excelApp.Workbooks.Add();
            excelApp.Visible = true;

            Excel.Range targetRange = excelApp.Range["A1"];
            targetRange.Value = "Name";
        }

        static void CSharp2008()
        {
            var excelApp = new Excel.Application();
            excelApp.Workbooks.Add(Type.Missing);
            excelApp.Visible = true;

            Excel.Range targetRange = excelApp.get_Range("A1", Type.Missing);
            targetRange.set_Value(Type.Missing, "Name");
            // Or
            //targetRange.Value2 = "Name";

        }
    }
}

참고 항목

다음을 통해 공유

방법: COM Interop 프로그래밍에서 인덱싱된 속성 사용(C# 프로그래밍 가이드)

예제

참고 항목

작업

참조

개념

기타 리소스

추가 리소스