Esempi di programmazione per fare riferimento a elementi e cartelle in Outlook 2002

Il modello a oggetti di Microsoft Outlook viene in genere utilizzato per accedere a diversi tipi di elementi nelle cartelle. In questo articolo viene fornita una panoramica dei diversi metodi, proprietà e oggetti utilizzabili per fare riferimento a elementi e cartelle di Outlook.

Nel presente articolo vengono discussi i seguenti argomenti:

Riferimenti a cartelle esistenti

• Metodo GetDefaultFolder
• Oggetto Folders
• Proprietà Parent
• Metodo GetSharedDefaultFolder
• Metodo GetFolderFromID

Creazione di nuove cartelle e aggiunta di riferimenti

• Metodo Folders.Add

Creazione di nuovi elementi e aggiunta di riferimenti

• Metodo CreateItem
• Metodo Items.Add
• Metodo CreateItemFromTemplate

Riferimenti a elementi esistenti

• Utilizzo di Items(I) o di For Each...Next
• Utilizzo di Items("This is the subject")
• Metodo Find
• Metodo Restrict
• Metodo GetItemFromID

Microsoft fornisce esempi di programmazione a scopo puramente illustrativo, senza alcuna garanzia di qualsiasi tipo, sia espressa che implicita, ivi incluse, senza limitazioni, le garanzie implicite di commerciabilità o idoneità per uno scopo particolare. In questo articolo si presume che l'utente conosca il linguaggio di programmazione in questione e gli strumenti utilizzati per creare ed eseguire il debug delle procedure. Gli esperti Microsoft sono autorizzati a fornire spiegazioni in merito alla funzionalità di una particolare procedura, ma in nessun caso a modificare questi esempi per fornire funzionalità aggiuntive o creare procedure atte a soddisfare specifiche esigenze. Se si dispone di esperienza di programmazione limitata, si consiglia di contattare un Microsoft Certified Partner o la filiale Microsoft locale per informazioni sulla consulenza tecnica. Per ulteriori informazioni in merito ai Microsoft Certified Partner, visitare il seguente sito Web Microsoft: Per ulteriori informazioni sulle opzioni di supporto disponibili e su come contattare Microsoft, visitare il seguente sito Web Microsoft: NOTA: nel codice Visual Basic, Scripting Edition (VBScript) è necessario utilizzare il valore numerico delle costanti definite nella libreria di oggetti di Outlook. Per ulteriori informazioni, fare clic sul numero dell'articolo della Microsoft Knowledge Base riportato di seguito:

Riferimenti a cartelle esistenti

Metodo GetDefaultFolder:

Le cartelle predefinite sono quelle allo stesso livello della Posta in arrivo in cui vengono ricevuti i messaggi. Se il profilo prevede più cartelle Posta in arrivo, premere CTRL+MAIUSC+I per selezionare quella predefinita. Le cartelle predefinite sono quelle utilizzate più di frequente dalla maggior parte degli utenti, ad esempio le cartelle Calendario, Contatti e Attività. È possibile fare agevolmente riferimento a queste cartelle utilizzando il metodo GetDefaultFolder. GetDefaultFolder necessita di un solo argomento, ossia il tipo di cartella a cui si desidera fare riferimento. Negli esempi riportati di seguito la variabile oggetto MyFolder viene assegnata alla cartella Contatti predefinita:

Oggetto Folders

È possibile utilizzare l'oggetto Folders per fare riferimento a qualsiasi cartella visibile nell'elenco delle cartelle di Outlook. Questo oggetto viene in genere utilizzato per fare riferimento a una cartella pubblica di Exchange o a qualsiasi altra cartella non predefinita di Outlook.

Negli esempi che seguono viene spiegato come fare riferimento a una cartella pubblica denominata "My Public Folder". Si noti che in genere si inizia con la cartella superiore fino a giungere a quella a cui fare riferimento. Tenere inoltre presente che i nomi delle cartelle fanno distinzione tra maiuscole e minuscole e devono corrispondere esattamente a quelli dell'elenco delle cartelle di Outlook.

Negli esempi che seguono viene spiegato come fare riferimento a una cartella denominata "Business Tasks", ovvero a una sottocartella della cartella Attività predefinita.

Proprietà Parent

Se si dispone già di un riferimento a un elemento o a una cartella di Outlook, è possibile utilizzare la proprietà Parent per creare un riferimento all'elemento o alla cartella in cui è inserito.

Gli esempi riportati di seguito consentono di restituire il nome di una cartella per un elemento specifico:

GetSharedDefaultFolder

È possibile utilizzare questo metodo se sono state ricevute autorizzazioni delegate per una delle cartelle predefinite di un altro utente.

Per ulteriori informazioni sull'accesso alle cartelle di altri utenti, fare clic sul numero dell'articolo della Knowledge Base riportato di seguito:

Il metodo GetSharedDefaultFolder viene utilizzato allo stesso modo di GetDefaultFolder, tuttavia in questo caso è necessario specificare un altro argomento, ovvero il nome della cartella dell'altro utente a cui fare riferimento. Questo esempio consente di risolvere il nome dell'altro utente in modo da verificare che si tratti di un nome valido ed utilizzabile con il metodo GetSharedDefaultFolder.

GetFolderFromID

Questo metodo viene in genere utilizzato in soluzioni più complesse in cui una soluzione tiene traccia dei valori StoreID ed EntryID di una cartella in modo da farvi più agevolmente riferimento in un secondo momento.

Per ulteriori informazioni sull'utilizzo del metodo GetFolderFromID, fare clic sul numero dell'articolo della Microsoft Knowledge Base riportato di seguito:

Creazione di nuove cartelle e aggiunta di riferimenti

Metodo Folders.Add

L'utilizzo del metodo Add nell'insieme Folders consente di creare una nuova cartella. Il primo argomento consente di specificare il nome della cartella, mentre il secondo il tipo. Il codice riportato di seguito aggiunge la sottocartella Business Tasks alla cartella Attività predefinita. Poiché il tipo di cartella non viene specificato, verrà ereditato il tipo della cartella principale.

Creazione di nuovi elementi e aggiunta di riferimenti

Metodo CreateItem

Il metodo CreateItem consente di creare un nuovo elemento predefinito di Outlook. Se è necessario creare un elemento basato su un modulo personalizzato già creato, utilizzare il metodo Items.Add riportato di seguito. Il metodo CreateItem è posizionato all'esterno dell'oggetto applicazione di livello superiore nel modello a oggetti di Outlook. Questo metodo prevede un solo argomento, ovvero una costante che indica il tipo di elemento da creare.

Metodo Items.Add

L'utilizzo del metodo Add nell'insieme Items consente di creare un nuovo elemento basato su qualsiasi classe di messaggio, sia che si tratti di una classe di messaggio predefinita di Outlook, quale IPM.Contact, oppure di una classe di messaggio per un modulo personalizzato, quale IPM.Contact.MyForm. Per poter utilizzare il metodo Items.Add, è necessario fare dapprima riferimento alla cartella in cui creare un nuovo elemento.

Per ulteriori informazioni sulle classi di messaggio, fare clic sul numero dell'articolo della Knowledge Base riportato di seguito:
Negli esempi che seguono il metodo Items.Add viene utilizzato per creare un nuovo elemento basato su un modulo contatto personalizzato denominato MyForm:



Negli esempi che seguono il metodo Items.Add viene utilizzato per creare un nuovo elemento contatto predefinito:

NOTA: se si utilizza il metodo Items.Add, non ha importanza quale sia il modulo predefinito per la cartella. È possibile specificare qualsiasi classe di messaggio valida purché pubblicata nella cartella o nella libreria moduli personale o organizzazione.

Metodo CreateItemFromTemplate

Utilizzare il metodo CreateItemFromTemplate per creare un nuovo elemento basato su un formato di file modello di Outlook (OFT) o di file MSG. Poiché la maggior parte dei moduli è pubblicata in una cartella o in una libreria di moduli, questo metodo non viene in genere utilizzato. Potrebbe essere necessario utilizzare questo metodo se si intende creare un programma di installazione di Microsoft Visual Basic per installare moduli per una soluzione Outlook. Ciò può rivelarsi utile per coloro che non dispongono di accesso alla rete o lavorano non in linea in Outlook. Il programma Visual Basic consente di effettuare quanto segue:

• Automatizzare Outlook.
• Utilizzare CreateItemFromTemplate per aprire un modulo da una condivisione di rete o da un disco.
• Con il modello a oggetti di Outlook, pubblicare il modulo per utilizzi successivi.

  ' Automation code example.
  Set ol = New Outlook.Application
  Set olns = ol.GetNameSpace("MAPI")
  ' Set MyFolder to the default contacts folder.
  Set MyFolder = olns.GetDefaultFolder(olFolderContacts)
  ' Set MyItem to an .oft file on a floppy disk.
  Set MyItem = ol.CreateItemFromTemplate("A:\Contact.oft")
  ' Set MyForm to the item Form Description for publishing.
  Set MyForm = MyItem.FormDescription
  ' Name the form, which also sets its message class.
  MyForm.Name = "My Contact"
  ' Publish the folder to the Contacts folder.
  MyForm.PublishForm olFolderRegistry, MyFolder
  ' Close and do not save changes to the item.
  MyItem.Close olDiscard
  					

Riferimenti a elementi esistenti

Utilizzo di Items(I) o di For Each...Next

In genere questi approcci vengono utilizzati per eseguire il ciclo di tutti gli elementi di una cartella. L'insieme Items contiene tutti gli elementi di una data cartella ed è possibile specificare gli elementi a cui fare riferimento utilizzando un indice con l'insieme Items. Tale soluzione viene in genere utilizzata con il costrutto di programmazione For I = 1 to n.

È possibile utilizzare il costrutto di programmazione For Each...Next per eseguire il ciclo di tutti gli elementi dell'insieme senza specificare un indice. Entrambi gli approcci consentono di ottenere lo stesso risultato.

Negli esempi che seguono viene utilizzato l'approccio Items(I) per eseguire il ciclo di tutti i contatti della cartella dei contatti e visualizzare il campo FullName relativo al nome in una finestra di dialogo.



Negli esempi che seguono viene utilizzato il costrutto For Each...Next per ottenere lo stesso risultato degli esempi precedenti:

Utilizzo di Items

È anche possibile utilizzare l'insieme Items e specificare una stringa di testo che corrisponda al campo dell'oggetto di un elemento. Si tratta di un approccio non utilizzato comunemente.

Gli esempi riportati di seguito consentono di visualizzare un elemento della Posta in arrivo, il cui oggetto contiene le parole "Please help on Friday!"

Metodo Find

Utilizzare il metodo Find per ricercare un elemento in una cartella sulla base del valore di uno dei campi. Se il metodo Find sortisce esito positivo, è poi possibile utilizzare il metodo FindNext per verificare la presenza di altri elementi che soddisfano gli stessi criteri di ricerca.

Gli esempi riportati di seguito consentono di verificare la presenza di appuntamenti con priorità elevata.

Metodo Restrict

Il metodo Restrict è simile al metodo Find, ma invece di restituire un singolo elemento, restituisce un insieme di elementi che soddisfano i criteri di ricerca. È ad esempio possibile utilizzare questo metodo per individuare tutti i contatti che lavorano per la stessa società.

Gli esempi riportati di seguito consentono di visualizzare tutti i contatti che lavorano per la ACME Software:


Per ulteriori informazioni sull'utilizzo del metodo Restrict, fare clic sul numero dell'articolo della Knowledge Base riportato di seguito:

Metodo GetItemFromID

Questo metodo viene in genere utilizzato in soluzioni più complesse in cui una soluzione tiene traccia dei valori StoreID ed EntryID di un elemento in modo da poterlo recuperare più velocemente in un secondo momento.

Per ulteriori informazioni sull'utilizzo del metodo GetFolderFromID, fare clic sul numero dell'articolo della Microsoft Knowledge Base riportato di seguito:

Per ulteriori informazioni sulle risorse disponibili e sulle risposte alle domande più frequenti relative alle soluzioni basate su Microsoft Outlook, vedere il seguente articolo della Microsoft Knowledge Base: