Cenni preliminari sul modello a oggetti di Outlook

Articolo
04/28/2010

Aggiornamento: novembre 2007

Per sviluppare componenti aggiuntivi per Microsoft Office Outlook, è possibile interagire con gli oggetti forniti dal modello a oggetti di Outlook. Questo modello fornisce classi che rappresentano gli elementi nell'interfaccia utente. Ad esempio, la classe Application rappresenta l'intera applicazione, la classe MAPIFolder rappresenta una cartella contenente messaggi di posta elettronica o altri elementi e la classe MailItem rappresenta un messaggio di posta elettronica.

In questo argomento viene fornita una breve panoramica di alcune delle classi principali del modello a oggetti di Outlook. Per la documentazione completa sul modello a oggetti di Outlook, vedere in MSDN le sezioni Outlook 2007 Developer Reference and Welcome to the Microsoft Office Outlook 2003 VBA Language Reference (informazioni in lingua inglese).

Accesso agli oggetti in un progetto Outlook

In Outlook sono disponibili numerose classi con cui è possibile interagire. Per utilizzare efficacemente il modello a oggetti è necessario conoscere le seguenti classi di livello superiore:

Classe Application

La classe Application rappresenta l'applicazione Outlook ed è la classe di livello più alto nel modello a oggetti di Outlook. Alcuni dei membri più importanti di questa classe sono:

Il metodo CreateItem che può essere utilizzato per creare un nuovo elemento, ad esempio un messaggio di posta elettronica, un'attività o un appuntamento.
La proprietà Explorers, che può essere utilizzata per accedere alle finestre in cui viene visualizzato il contenuto di una cartella nell'interfaccia utente (UI) di Outlook.
La proprietà Inspectors, che può essere utilizzata per accedere alle finestre in cui viene visualizzato il contenuto di un singolo elemento, ad esempio un messaggio di posta elettronica o una convocazione riunione.

Per ottenere un'istanza della classe Application, utilizzare la proprietà Application della classe ThisAddin.

Classe ThisAddIn

Quando si crea un nuovo progetto componente aggiuntivo Outolook, Visual Studio Tools per Office crea automaticamente un file di codice ThisAddIn.vb o ThisAddIn.cs nel nuovo progetto. Questo file di codice definisce una classe ThisAddin che eredita da OutlookAddIn. È possibile accedere ai membri della classe OutlookAddIn utilizzando la parola chiave Me (in Visual Basic) o this (in C#) nella classe ThisAddIn. Il codice che si trova all'esterno della classe ThisAddIn è in grado di accedere all'oggetto ThisAddIn utilizzando la proprietà statica Globals.ThisAddIn.

Nota:
Per evitare gli avvisi di sicurezza quando si utilizzano proprietà e metodi bloccati dalla protezione del modello a oggetti di Outlook, ottenere oggetti Outlook dall'oggetto ThisAddIn. Per ulteriori informazioni, vedere Considerazioni specifiche sulla protezione per le soluzioni Office.

Classe Explorer

La classe Explorer rappresenta una finestra in cui viene visualizzato il contenuto di una cartella che include elementi quali messaggi di posta elettronica, attività o appuntamenti. Nella classe Explorer sono inclusi metodi e proprietà che possono essere utilizzati per modificare la finestra, nonché eventi che vengono generati quando la finestra viene modificata.

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

Utilizzare la proprietà Explorers della classe Application per accedere a tutti gli oggetti Explorer disponibili in Outlook.
Utilizzare il metodo ActiveExplorer della classe Application per ottenere l'oggetto Explorer attualmente attivo.
Utilizzare il metodo GetExplorer della classe MAPIFolder per ottenere l'oggetto Explorer della cartella corrente.

Classe Inspector

La classe Inspector rappresenta una finestra in cui viene visualizzato un singolo elemento, ad esempio un messaggio di posta elettronica, un'attività o un appuntamento. Nella classe Inspector sono inclusi metodi e proprietà che possono essere utilizzati per modificare la finestra, nonché eventi che vengono generati quando la finestra viene modificata.

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

Utilizzare la proprietà Inspectors della classe Application per accedere a tutti gli oggetti Inspector disponibili in Outlook.
Utilizzare il metodo ActiveInspector della classe Application per ottenere l'oggetto Inspector attualmente attivo.
Utilizzare il metodo GetInspector di un elemento specifico, ad esempio MailItem o AppointmentItem, per recuperare il controllo a esso associato.

Classe MAPIFolder

La classe MAPIFolder rappresenta una cartella contenente messaggi di posta elettronica, contatti, attività e altri elementi. In Outlook sono disponibili 16 oggetti MAPIFolder predefiniti.

Gli oggetti MAPIFolder predefiniti sono specificati dai valori di enumerazione OlDefaultFolders. Ad esempio,

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

Per un esempio in cui venga illustrato come accedere a un oggetto MAPIFolder predefinito e creare un nuovo oggetto MAPIFolder, vedere Procedura: creare cartelle personalizzate.

Classe MailItem

La classe MailItem rappresenta un messaggio di posta elettronica. Gli oggetti MailItem in genere sono contenuti all'interno di cartelle, ad esempio Posta in arrivo, Elementi inviati e Posta in uscita. La classe MailItem espone le proprietà e i metodi che possono essere utilizzati per creare e inviare messaggi di posta elettronica.

Per un esempio in cui venga illustrato come creare un messaggio di posta elettronica, vedere Procedura: creare un elemento di posta elettronica.

Classe AppointmentItem

La classe AppointmentItem rappresenta un appuntamento occasionale o ricorrente oppure una riunione contenuta nella cartella Calendario. Nella classe AppointmentItem sono inclusi metodi che eseguono azioni quali la risposta o l'inoltro di convocazioni riunione e proprietà che specificano i dettagli delle riunioni, ad esempio il luogo e l'ora.

Per un esempio in cui venga illustrato come creare un appuntamento, vedere Procedura: creare una convocazione riunione.

Classe TaskItem

La classe TaskItem rappresenta un'attività da eseguire in un intervallo di tempo specificato. Gli oggetti TaskItem sono contenuti nella cartella Attività.

Per creare un'attività, utilizzare il metodo CreateItem della classe Application e passare il valore olTaskItem per il parametro.

Classe ContactItem

La classe ContactItemrappresenta un contatto della cartella Contatti. Gli oggetti ContactItem contengono numerose informazioni relative alle persone che rappresentano, ad esempio indirizzi stradali, indirizzi di posta elettronica e numeri di telefono.

Per un esempio in cui venga illustrato come creare un nuovo contatto, vedere Procedura: aggiungere una voce ai contatti di Outlook. Per un esempio in cui venga illustrato come cercare un contatto esistente, vedere Procedura: eseguire la ricerca di un contatto specifico.

Utilizzo della documentazione sul modello a oggetti di Outlook

Per informazioni sulle classi utilizzabili nel modello a oggetti di Outlook, vedere i seguenti argomenti della documentazione:

Il primo collegamento fornisce informazioni sulle classi e sulle interfacce nell'assembly di interoperabilità primario per Outlook. L'altro collegamento fornisce informazioni sul modello a oggetti di Outlook esposto al codice Visual Basic, Applications Edition (VBA). Ogni argomento della documentazione presenta vantaggi e svantaggi per gli sviluppatori che utilizzano Visual Studio Tools per Office.

Riferimento all'assembly di interoperabilità primario

In questa documentazione vengono descritti tutti i tipi nell'assembly di interoperabilità primario per Outlook che è possibile utilizzare nei progetti Visual Studio Tools per Office.

Vengono descritti i tipi nell'assembly di interoperabilità primario per Outlook 2007. Nello sviluppo di un componente aggiuntivo per Outlook 2003, pertanto, non sarà possibile utilizzare alcune delle classi e alcuni dei membri presenti nella documentazione. Per una descrizione dei tipi e dei membri disponibili per Outlook 2003, consultare i riferimenti del linguaggio VBA per Microsoft Office Outlook 2003.
Al momento non viene fornito alcun esempio di codice.

Riferimenti VBA

Tutti gli oggetti e i membri nei riferimenti del linguaggio VBA corrispondono a classi e membri nell'assembly di interoperabilità primario utilizzato nei progetti Visual Studio Tools per Office. L'oggetto Inspector menzionato nella documentazione VBA per Outlook, ad esempio, corrisponde alla classe Microsoft.Office.Interop.Outlook.Inspector dell'assembly di interoperabilità primario.

I riferimenti VBA presentano i vantaggi seguenti:

Forniscono esempi di codice per la maggior parte dei membri.

I riferimenti VBA presentano gli svantaggi seguenti:

Fornisce sintassi ed esempi di codice unicamente per VBA. Per utilizzare gli esempi di codice in un progetto Visual Studio Tools per Office, è necessario convertire il codice VBA in Visual Basic o Visual C#.

Tipi aggiuntivi negli assembly di interoperabilità primari

Gli assembly di interoperabilità primari contengono molti tipi non disponibili per VBA. I tipi aggiuntivi, che consentono di convertire gli oggetti nel modello a oggetti COM di Outlook in codice gestito, non possono essere utilizzati direttamente nel codice.

Per ulteriori informazioni, vedere Architecture of the Outlook PIA (informazioni in lingua inglese).