Panoramica del modello a oggetti di Outlook

Per sviluppare componenti aggiuntivi VSTO per Microsoft Office Outlook, è possibile interagire con gli oggetti forniti dal modello a oggetti di Outlook. Il modello a oggetti di Outlook fornisce classi e interfacce che rappresentano elementi nell'interfaccia utente. Ad esempio, l'oggetto Application rappresenta l'intera applicazione, l'oggetto Folder rappresenta una cartelle che contiene messaggi di posta elettronica o altri elementi e l'oggetto MailItem rappresenta un messaggio di posta elettronica.

Questo argomento fornisce una breve panoramica di alcuni degli oggetti principali del modello a oggetti di Outlook. Per le risorse in cui è possibile ottenere altre informazioni sull'intero modello a oggetti di Outlook, vedere Usare la documentazione del modello a oggetti di Outlook.

Si applica a: le informazioni contenute in questo argomento si applicano ai progetti di componente aggiuntivo VSTO per Outlook. Per altre informazioni, vedere Funzionalità disponibili per app Office lication e tipo di progetto.

Accedere agli oggetti in un progetto di Outlook

Outlook offre numerosi oggetti con cui è possibile interagire. Per usare in modo efficace il modello a oggetti, è necessaria una familiarità con gli oggetti principali seguenti:

• Application

• Explorer

• Inspector

• Folder

• MailItem

• AppointmentItem

• TaskItem

• ContactItem

Oggetto applicazione

L'oggetto Application rappresenta l'applicazione Outlook ed è l'oggetto di livello massimo nel modello a oggetti di Outlook. Alcuni dei membri più importanti di questo oggetto includono i seguenti:

• Il metodo CreateItem , che può essere usato per creare un nuovo elemento, ad esempio un messaggio di posta elettronica, un'attività o un appuntamento.

• La proprietà Explorers , che permette di accedere alle finestre che mostrano i contenuti di una cartella nell'interfaccia utente di Outlook.

• La proprietà Inspectors , che permette di accedere alle finestre che mostrano i contenuti di un singolo elemento, ad esempio un messaggio di posta elettronica o una convocazione riunione.

  Per ottenere un'istanza dell'oggetto Application , usare il campo Application della ThisAddIn classe nel progetto. Per altre informazioni, vedere Programmare componenti aggiuntivi VSTO.

Nota

Per evitare avvisi di sicurezza quando si utilizzano proprietà e metodi bloccati dalla protezione del modello a oggetti di Outlook, ottenere oggetti di Outlook dal campo Application della ThisAddIn classe . Per altre informazioni, vedere Considerazioni specifiche sulla sicurezza per le soluzioni Office.

Oggetto Explorer

L'oggetto Explorer rappresenta una finestra che mostra i contenuti di una cartella che include elementi quali messaggi di posta elettronica, attività o appuntamenti. L'oggetto Explorer include metodi e proprietà che possono essere usati per modificare la finestra ed eventi che vengono generati quando la finestra viene modificata.

Per ottenere un oggetto Explorer , eseguire una delle operazioni seguenti:

• Usare la proprietà Explorers dell'oggetto Application per accedere a tutti gli oggetti Explorer in Outlook.

• Usare il metodo ActiveExplorer dell'oggetto Application per ottenere l'oggetto Explorer che ha attualmente lo stato attivo.

• Usare il metodo GetExplorer dell'oggetto Folder per ottenere l'oggetto Explorer per la cartella corrente.

Oggetto Inspector

L'oggetto Inspector rappresenta una finestra che mostra un singolo elemento, ad esempio un messaggio di posta elettronica, un'attività o un appuntamento. L'oggetto Inspector include metodi e proprietà che possono essere usati per modificare la finestra ed eventi che vengono generati quando la finestra viene modificata.

Per ottenere un oggetto Inspector , eseguire una delle operazioni seguenti:

• Usare la proprietà Inspectors dell'oggetto Application per accedere a tutti gli oggetti Inspector in Outlook.

• Usare il metodo ActiveInspector dell'oggetto Application per ottenere l'oggetto Inspector che ha attualmente lo stato attivo.

• Usare il metodo GetInspector di un elemento specifico, ad esempio MailItem o AppointmentItem, per ottenere l'oggetto Inspector associato.

Oggetto Folder

L'oggetto Folder rappresenta una cartella che contiene messaggi di posta elettronica, contatti, attività e altri elementi. Outlook offre 16 oggetti Folder predefiniti.

Gli oggetti Folder predefiniti vengono definiti dai valori di enumerazione OlDefaultFolders . ad esempio:

Microsoft.Office.Interop.Outlook.OlDefaultFolders.olFolderInbox corrisponde alla cartella Posta in arrivo in Outlook.

Per un esempio che illustra come accedere a un valore predefinito Folder e creare un nuovo Folderoggetto , vedere Procedura: Creare elementi di cartelle personalizzati a livello di codice.

Oggetto MailItem

L'oggetto MailItem rappresenta un messaggio di posta elettronica. Gli oggettiMailItem si trovano in genere nelle cartelle, ad esempio Posta in arrivo, Posta inviatae Posta in uscita. MailItem espone proprietà e metodi che possono essere usati per creare e inviare messaggi di posta elettronica.

Per un esempio che illustra come creare un messaggio di posta elettronica, vedere Procedura: Creare un elemento di posta elettronica a livello di codice.

Oggetto AppointmentItem

L'oggetto AppointmentItem rappresenta una riunione, un appuntamento singolo o un appuntamento o riunione ricorrente nella cartella Calendario . L'oggetto AppointmentItem include metodi che eseguono azioni, quali la risposta o l'inoltro di una convocazione riunione, e proprietà che specificano i dettagli della riunione, ad esempio luogo e ora.

Per un esempio che illustra come creare un appuntamento, vedere Procedura: Creare una convocazione di riunione a livello di codice.

Oggetto TaskItem

L'oggetto TaskItem rappresenta un'attività da eseguire entro un intervallo di tempo specificato. Gli oggettiTaskItem si trovano nella cartella Attività .

Per creare un'attività, usare il metodo CreateItem dell'ogetto Application e passare il valore olTaskItem per il parametro.

Oggetto ContactItem

L'oggetto ContactItemrappresenta un contatto nella cartella Contatti . Gli oggettiContactItem contengono diverse informazioni di contatto per le persone rappresentate, ad esempio via e numero civico, indirizzo di posta elettronica e numeri di telefono.

Per un esempio che illustra come creare un nuovo contatto, vedere Procedura: Aggiungere una voce ai contatti di Outlook a livello di codice. Per un esempio che illustra come cercare un contatto esistente, vedere Procedura: Cercare un contatto specifico a livello di codice.

Usare la documentazione del modello a oggetti di Outlook

Per informazioni complete sul modello a oggetti di Outlook, è possibile usare il riferimento di assembly di interoperabilità primario di Outlook e il riferimento del modello a oggetti VBA.

Informazioni di riferimento sull'assembly di interoperabilità primario

Il riferimento degli assembly di interoperabilità primari di Outlook documenta i tipi disponibili negli assembly di interoperabilità primari per Outlook 2010. Per altre informazioni, vedere Informazioni di riferimento sull'assembly di interoperabilità primario di Outlook 2010.

Oltre a fornire informazioni per tutti i tipi disponibili negli assembly di interoperabilità primari, questa documentazione fornisce anche informazioni aggiuntive sulla struttura degli assembly di interoperabilità primari ed esempi di codice per attività di automazione comuni di Outlook.

Informazioni di riferimento sul modello a oggetti VBA

Nel riferimento del modello a oggetti VBA è illustrato il modello a oggetti di Outlook esposto al codice Visual Basic Applications (VBA). Per altre informazioni, vedere Informazioni di riferimento sul modello a oggetti di Outlook 2010.

Tutti gli oggetti e i membri del riferimento del modello a oggetti VBA corrispondono ai tipi e ai membri dell'assembly di interoperabilità primario di Outlook. Ad esempio, l'oggetto Inspector nel riferimento al modello a oggetti VBA corrisponde all'oggetto nell'elenco Inspector di interoperabilità primario di Outlook. Sebbene il riferimento del modello a oggetti di VBA fornisca esempi di codice per la maggior parte delle proprietà, dei metodi e degli eventi, è necessario convertire il codice VBA in questo riferimento a Visual Basic o a Visual C# se si vuole usarli in un progetto di componente aggiuntivo VSTO di Outlook creato con Visual Studio.

Argomenti correlati

Posizione	Descrizione
Utilizzare gli elementi di contatto	Fornisce argomenti che illustrano come eseguire attività con i contatti.
Usare gli elementi di posta elettronica	Fornisce argomenti che illustrano come eseguire attività con gli elementi di posta elettronica.
Usare le cartelle	Fornisce argomenti che illustrano come eseguire attività con le cartelle.
Usare gli elementi del calendario	Fornisce argomenti che illustrano come eseguire attività con gli elementi di calendario.
Procedura: Determinare l'elemento di Outlook corrente a livello di codice	Illustra come visualizzare il nome della cartella corrente e alcune informazioni sull'elemento selezionato.