다음을 통해 공유


Outlook 개체 모델 개요

업데이트: 2007년 11월

Microsoft Office Outlook용 추가 기능을 개발하기 위해 Outlook 개체 모델에서 제공하는 개체와 상호 작용할 수 있습니다. Outlook 개체 모델은 사용자 인터페이스에 항목을 나타내는 클래스를 제공합니다. 예를 들어 Application 클래스는 전체 응용 프로그램을 나타내고 MAPIFolder 클래스는 전자 메일 메시지 또는 다른 항목이 들어 있는 폴더를 나타내며 MailItem 클래스는 전자 메일 메시지를 나타냅니다.

이 항목에서는 Outlook 개체 모델의 주 클래스 중 일부를 간단히 소개합니다. Outlook 개체 모델에 대한 전체 설명서를 보려면 MSDN의 Outlook 2007 Developer ReferenceWelcome to the Microsoft Office Outlook 2003 VBA Language Reference 단원을 참조하십시오.

Outlook 프로젝트에서 개체 액세스

Outlook은 상호 작용할 수 있는 많은 클래스를 제공합니다. 개체 모델을 효율적으로 사용하려면 다음과 같은 최상위 클래스에 익숙해야 합니다.

Application 클래스

Application 클래스는 Outlook 응용 프로그램을 나타내고 Outlook 개체 모델의 최상위 클래스입니다. 이 클래스의 가장 중요한 일부 멤버는 다음과 같습니다.

  • 전자 메일 메시지, 작업 또는 약속 같은 새 항목을 만드는 데 사용할 수 있는 CreateItem 메서드

  • Outlook UI(사용자 인터페이스)에 폴더 내용을 표시하는 창에 액세스하는 데 사용할 수 있는 Explorers 속성

  • 전자 메일 메시지나 모임 요청과 같은 단일 항목의 이름을 표시하는 창에 액세스하는 데 사용할 수 있는 Inspectors 속성

Application 클래스의 인스턴스를 가져오려면 ThisAddin 클래스의 Application 속성을 사용합니다.

ThisAddIn 클래스

새 Outlook 추가 기능 프로젝트를 만들면 Visual Studio Tools for Office에서는 새 프로젝트에 ThisAddIn.vb 또는 ThisAddIn.cs 코드 파일을 자동으로 만듭니다. 이 코드 파일은 OutlookAddIn에서 상속되는 ThisAddin 클래스를 정의합니다. ThisAddIn 클래스 내에서 Me(Visual Basic의 경우) 또는 this(C#의 경우) 키워드를 사용하여 OutlookAddIn 클래스의 멤버에 액세스할 수 있습니다. ThisAddIn 클래스 외부에 있는 코드에서는 정적 Globals.ThisAddIn 속성을 사용하여 ThisAddIn 개체에 액세스할 수 있습니다.

참고:

Outlook 개체 모델 가드에 의해 차단되는 속성 및 메서드를 사용할 때 보안 경고가 표시되지 않도록 하려면 ThisAddIn 개체에서 Outlook 개체를 가져옵니다. 자세한 내용은 Office 솔루션에 대한 특정 보안 고려 사항을 참조하십시오.

Explorer 클래스

Explorer 클래스는 전자 메일 메시지, 작업 또는 약속과 같은 항목이 들어 있는 폴더의 내용을 표시하는 창을 나타냅니다. Explorer 클래스에는 창을 수정하는 데 사용할 수 있는 메서드와 속성 및 창이 변경될 때 발생하는 이벤트가 포함되어 있습니다.

Explorer 개체를 가져오려면 다음 중 하나를 수행합니다.

Inspector 클래스

Inspector 클래스는 전자 메일 메시지, 작업 또는 약속과 같은 단일 항목을 표시하는 창을 나타냅니다. Inspector 클래스에는 창을 수정하는 데 사용할 수 있는 메서드와 속성 및 창이 변경될 때 발생하는 이벤트가 포함되어 있습니다.

Inspector 개체를 가져오려면 다음 중 하나를 수행합니다.

MAPIFolder 클래스

MAPIFolder 클래스는 전자 메일 메시지, 연락처, 작업 및 기타 항목이 들어 있는 폴더를 나타냅니다. Outlook에서는 16개의 기본 MAPIFolder 개체를 제공합니다.

기본 MAPIFolder 개체는 OlDefaultFolders 열거형 값에 의해 정의됩니다. 예를 들면 다음과 같습니다.

T:Microsoft.Office.Interop.Outlook.OlDefaultFolders.olFolderInbox는 Outlook의 받은 편지함 폴더에 해당합니다.

기본 MAPIFolder에 액세스하고 새 MAPIFolder를 만드는 방법을 보여 주는 예제는 방법: 사용자 지정 폴더 항목 만들기를 참조하십시오.

MailItem 클래스

MailItem 클래스는 전자 메일 메시지를 나타냅니다. MailItem 개체는 일반적으로 받은 편지함, 보낸 편지함보낼 편지함과 같은 폴더에 있습니다. MailItem은 전자 메일 메시지를 만들고 보내는 데 사용할 수 있는 속성과 메서드를 노출합니다.

전자 메일 메시지를 만드는 방법을 보여 주는 예제는 방법: 전자 메일 항목 만들기를 참조하십시오.

AppointmentItem 클래스

AppointmentItem 클래스는 모임, 1회성 약속 또는 되풀이 약속이나 모임을 일정 폴더에 나타냅니다. AppointmentItem 클래스에는 모임 요청에 응답하거나 모임 요청을 전달하는 등의 작업을 수행하는 메서드와 위치 및 시간과 같은 모임 정보를 지정하는 속성이 포함되어 있습니다.

약속을 만드는 방법을 보여 주는 예제는 방법: 모임 요청 만들기를 참조하십시오.

TaskItem 클래스

TaskItem 클래스는 지정한 시간대에 수행될 약속을 나타냅니다. TaskItem 개체는 작업 폴더에 있습니다.

작업을 만들려면 Application 클래스의 CreateItem 메서드를 사용하고 매개 변수에 olTaskItem 값을 전달합니다.

ContactItem 클래스

ContactItem클래스는 연락처 폴더에 연락처를 나타냅니다. ContactItem 개체에는 해당 개체가 나타내는 사람에 대한 다양한 연락처 정보(예: 주소, 전자 메일 주소, 전화 번호 등)가 들어 있습니다.

새 연락처를 만드는 방법을 보여 주는 예제는 방법: Outlook 연락처에 엔트리 추가를 참조하십시오. 기존 연락처를 검색하는 방법을 보여 주는 예제는 방법: 특정 연락처 검색을 참조하십시오.

Outlook 개체 모델 설명서 사용

Outlook 개체 모델에서 사용할 수 있는 클래스에 대한 자세한 내용은 다음 설명서를 참조하십시오.

첫째 링크에서는 Outlook에 대한 주 interop 어셈블리의 클래스 및 인터페이스에 대한 정보를 제공합니다. 다른 링크에서는 VBA(Visual Basic for Applications) 코드에 노출되는 Outlook 개체 모델에 대한 정보를 제공합니다. 각 설명서를 사용하면 Visual Studio Tools for Office를 사용하는 개발자 대해 장점과 단점이 있습니다.

주 Interop 어셈블리 참조

이 설명서에서는 Visual Studio Tools for Office 프로젝트에서 사용할 수 있는 Outlook 주 interop 어셈블리의 모든 형식에 대해 설명합니다.

  • 여기서는 Outlook 2007의 주 interop 어셈블리 형식을 설명합니다. 따라서 Outlook 2003 추가 기능을 개발하는 경우에는 이 설명서에 나와 있는 클래스와 멤버 중 일부를 사용할 수 없습니다. Outlook 2003에 사용할 수 있는 형식과 멤버에 대한 설명은 Microsoft Office Outlook 2003 VBA Language Reference를 참조하십시오.

  • 현재 코드 예제를 제공하지 않습니다.

VBA 참조

VBA 참조의 모든 개체 및 멤버는 Visual Studio Tools for Office 프로젝트에서 사용하는 주 interop 어셈블리의 클래스 및 멤버에 해당합니다. 예를 들어 Outlook VBA 설명서의 Inspector 개체는 주 interop 어셈블리의 Microsoft.Office.Interop.Outlook.Inspector 클래스에 해당합니다.

VBA 참조를 사용하면 다음과 같은 장점이 있습니다.

  • 대부분의 멤버에 대한 코드 예제를 제공합니다.

VBA 참조를 사용하면 다음과 같은 단점이 있습니다.

  • VBA 전용 구문 및 코드 예제를 제공합니다. Visual Studio Tools for Office 프로젝트에서 해당 코드 예제를 사용하려면 VBA 코드를 Visual Basic 또는 Visual C#으로 변환해야 합니다.

주 Interop 어셈블리의 추가 형식

주 interop 어셈블리에는 VBA에서 사용할 수 없는 많은 형식이 들어 있습니다. 이러한 추가 형식은 Outlook의 COM 기반 개체 모델에 포함된 개체를 관리 코드로 변환하는 데 유용하지만 코드에서 직접 사용할 수는 없습니다.

자세한 내용은 Architecture of the Outlook PIA를 참조하십시오.

참고 항목

작업

방법: Outlook 솔루션에 Windows Forms 추가

방법: Outlook에 사용자 지정 메뉴 및 메뉴 항목 추가

방법: Outlook에 사용자 지정 도구 모음 및 도구 모음 항목 추가

방법: 도구 모음 및 메뉴 항목에 사용자 지정 아이콘 추가

방법: Outlook 세션 간에 사용자 지정 도구 모음의 위치 정보 유지

방법: 항목의 사용자 지정 필드에 있는 데이터 읽기

방법: 저장되지 않은 항목의 상위 폴더 결정

방법: 현재 Outlook 항목 확인

개념

Office 솔루션에 대한 특정 보안 고려 사항

Office 솔루션 개발 개요

연락처 항목 작업

메일 항목 작업

폴더 사용

달력 항목 작업