Programação exemplos que podem fazer referência itens e pastas no Outlook usando .NET translation from VPE for Csharp Visual

Support for Office 2003 has ended

Microsoft ended support for Office 2003 on April 8, 2014. This change has affected your software updates and security options. Learn what this means for you and how to stay protected.

IMPORTANTE: Este artigo foi traduzido por um sistema de tradução automática (também designado por Machine Translation ou MT), não tendo sido portanto traduzido ou revisto por pessoas. A Microsoft possui artigos traduzidos por aplicações (MT) e artigos traduzidos por tradutores profissionais, com o objetivo de oferecer em português a totalidade dos artigos existentes na base de dados de suporte. No entanto, a tradução automática não é sempre perfeita, podendo conter erros de vocabulário, sintaxe ou gramática. A Microsoft não é responsável por incoerências, erros ou prejuízos ocorridos em decorrência da utilização dos artigos MT por parte dos nossos clientes. A Microsoft realiza atualizações freqüentes ao software de tradução automática (MT). Obrigado.

Clique aqui para ver a versão em Inglês deste artigo: 310244
Este artigo foi arquivado. É oferecido "como está" e não será mais atualizado.
INTRODUÇÃO
O modelo de objeto do Microsoft Outlook é usado geralmente para acessar vários tipos de itens em pastas. Este artigo contém exemplos dos objetos que você pode usar para referir-se o Outlook, as propriedades e os métodos de itens e pastas do Outlook usando o Microsoft Visual translation from VPE for Csharp. NET.

Este artigo contém os tópicos a seguir e suas amostras associadas:
  • Referenciar pastas existentes
    • método GetDefaultFolder
    • objeto de pastas
    • propriedade Parent
    • método GetSharedDefaultFolder
    • método GetFolderFromID
  • Criando novas pastas e referenciar novas pastas
    • método Folders.Add
  • Criar novos itens e referenciar novos itens
    • método CreateItem
    • método Items.Add
    • método CreateItemFromTemplate
  • Referenciar itens existentes
    • método Usando itens (i)
    • método Items("Subject") usando
    • método Find
    • método Restrict
    • método GetItemFromID
Mais Informações
Para adicionar o código de exemplo para iniciar o aplicativo, siga estas etapas:
  1. Inicie o Microsoft Visual Studio NET..
  2. No menu arquivo , clique em novo e, em seguida, clique em Project .
  3. Em tipos de projetos do .NET translation from VPE for Csharp Visual , clique em Aplicativo de console .

    Por padrão, Class1.cs é criado.
  4. Adicionar uma referência para o objeto do Microsoft Outlook 10.0 biblioteca. Para fazer isso, execute as seguintes etapas:
    1. No menu Project , clique em Adicionar referência .
    2. Na guia COM , clique em Microsoft Outlook 10.0 Object Library e, em seguida, clique em Selecionar .
    3. Na caixa de diálogo Add References , clique em OK para aceitar as seleções.
    4. Clique em Sim se você receber uma mensagem para gerar wrappers para as bibliotecas que você selecionou.
  5. Na janela código, localize a linha de código a seguir.
    // TODO: Add code here to start the application.
    Leia as amostras que seguem. Substitua o código de exemplo que você queira tentar linha de código anterior.

Referenciar pastas existentes

Método GetDefaultFolder

As pastas padrão são as pastas que estão no mesmo nível como caixa de entrada que recebe seus emails de entrada. Se você tiver mais de uma caixa de entrada em seu perfil, você pode pressionar CTRL+SHIFT + I para selecionar a caixa de entrada padrão. As pastas padrão são as pastas que você trabalha regularmente, como a pasta Calendário, a pasta Contatos e a pasta tarefas. Você facilmente pode se referir a essas pastas usando o método GetDefaultFolder . O método GetDefaultFolders tem um argumento que define o tipo de pasta que você deseja se referir. Um objeto do Outlook tem uma enumeração que você pode selecionar. Essa enumeração é definida no tipo enum Outlook.OlDefaultFolders. O seguinte código de exemplo atribui a variável de objeto oFolder a caixa de entrada o padrão pasta
Outlook._Application olApp = new Outlook.ApplicationClass();Outlook._NameSpace olNS = olApp.GetNamespace("MAPI");Outlook.MAPIFolder oFolder = olNS.GetDefaultFolder(Outlook.OlDefaultFolders.olFolderInbox);Console.Write(oFolder.Name);

Objeto de pastas

Você pode usar o objeto Folders para fazer referência a qualquer pasta que está na lista de pasta do Outlook. O objeto Folders é normalmente usado para se referir a uma pasta do Microsoft Exchange ou a qualquer outra pasta que não é uma pasta predefinida do Outlook.

O código de exemplo a seguir ilustra como referir-se para uma pasta pública que é chamada de pasta pública de meu. Observe que você iniciar normalmente na pasta superior e funcionam sua forma para baixo para a pasta que você precisa para referência. Observe também que os nomes de pasta são diferencia maiúsculas de minúsculas. Você precisa coincidir exatamente o uso de maiúsculas e minúsculas e os nomes que aparecem na lista de pastas do Outlook.
// TODO: Add code here to start the application.Outlook._Application olApp = new Outlook.ApplicationClass();Outlook._NameSpace olNS = olApp.GetNamespace("MAPI");Outlook._Folders oFolders;oFolders = olNS.Folders;Outlook.MAPIFolder oPublicFolder = oFolders.Item("Public Folders");oFolders = oPublicFolder.Folders;Outlook.MAPIFolder oAllPFolder = oFolders.Item("All Public Folders");oFolders = oAllPFolder.Folders;Outlook.MAPIFolder oMyFolder  = oFolders.Item("My Public Folder");Console.Write(oMyFolder.Name);

Propriedade Parent

Se você já tiver uma referência a um item do Outlook ou para uma pasta do Outlook, você pode usar a propriedade pai do item do Outlook ou da pasta do Outlook para criar uma referência para a pasta que o item ou a pasta está localizada na.

O código de exemplo a seguir retorna o nome de uma pasta para um item específico.
Parent :// TODO: Add code here to start the application.Outlook._Application olApp = new Outlook.ApplicationClass();Outlook._MailItem oMailItem = (Outlook._MailItem)  olApp.CreateItem(Outlook.OlItemType.olMailItem);Outlook.MAPIFolder oFolder = (Outlook.MAPIFolder) oMailItem.Parent;Console.Write(oFolder.Name);

Método GetSharedDefaultFolder

Você pode usar esse método se outra pessoa tiver concedido permissão para uma das suas pastas padrão. Você use o método GetSharedDefaultFolder como você usa o método GetDefaultFolder , exceto que você deve especificar um argumento adicional. O um argumento adicional é o nome da pasta que pertence a outra pessoa. Esta é a pasta que você deseja referenciar. O seguinte código de exemplo resolve o nome da pessoa para verificar que o nome da outra pessoa é válido e que o nome da outra pessoa pode ser usado com o método GetSharedDefaultFolder .
GetSharedDefaultFolder:// TODO: Add code here to start the application.Outlook._Application olApp = new Outlook.ApplicationClass();Outlook._NameSpace olNs = olApp.GetNamespace("MAPI");Outlook.Recipient oRecip = olNs.CreateRecipient("Brian Baker");oRecip.Resolve();if (oRecip.Resolved) {Outlook.MAPIFolder oFolder = olNs.GetSharedDefaultFolder(oRecip,Outlook.OlDefaultFolders.olFolderCalendar);Console.Write(oFolder.Name);}
Para obter mais informações sobre como acessar informações em pastas que pertencem a outras pessoas, clique no número abaixo para ler o artigo na Base de dados de Conhecimento da Microsoft:
290824Como abrir o calendário de outro usuário ou outra pasta no Outlook 2002

Método GetFolderFromID

Este método geralmente é usado com soluções mais complexas em que uma solução mantém controle sobre o campo EntryID e o campo de identificação de armazenamento de uma pasta para que a pasta pode ser rapidamente referenciada mais tarde. Para obter informações adicionais, consulte o artigo 293152 na seção "Referências".

Criando novas pastas e referenciar novas pastas

Método Folders.Add

Quando você usa o método Folders.Add usando o método Add da coleção de pastas , você pode criar uma nova pasta. O primeiro argumento especifica o nome da pasta e o segundo argumento especifica o tipo da pasta. O código de exemplo a seguir adiciona uma subpasta de tarefas particulares à pasta padrão tarefas.
Folders.Add Method:// TODO: Add code here to start the application.Outlook._Application olApp = new Outlook.ApplicationClass();Outlook._NameSpace olNs = olApp.GetNamespace("MAPI");Outlook.MAPIFolder oTasks = olNs.GetDefaultFolder(Outlook.OlDefaultFolders.olFolderTasks);Outlook.Folders oFolders = oTasks.Folders;Outlook.MAPIFolder  oPersonalTasks = oFolders.Add("Personal Tasks",Outlook.OlDefaultFolders.olFolderTasks);Console.Write(oPersonalTasks.Name);

Criar novos itens e referenciar novos itens

Método CreateItem

O método CreateItem cria um novo item do Outlook padrão. Caso você precise criar um item baseado em um formulário personalizado que você criou, use o método Items.Add descrita no próximo exemplo. Você pode encontrar o método CreateItem localizado no objeto aplicativo de nível superior no Outlook modelo de objeto. O método CreateItem requer apenas um argumento. Esse um argumento é uma constante que indica o tipo de item para criar.
Outlook._Application olApp = new Outlook.ApplicationClass();Outlook._MailItem oMailItem = (Outlook._MailItem) olApp.CreateItem(Outlook.OlItemType.olMailItem);oMailItem.Display(false);

Método Items.Add

Quando você usa o método Add na coleção Items, você pode criar um novo item baseado em qualquer classe de mensagem. A classe da mensagem pode ser uma classe de mensagem de Outlook padrão, como a classe de mensagem IPM.contato ou uma classe de mensagem para um formulário personalizado, como a classe de mensagem de IPM.contato.MeuFormulário . Para usar o método Items.Add , primeiro você deve fazer referência a pasta onde você deseja criar um novo item.

Para obter mais informações sobre classes de mensagens, clique nos números abaixo para ler os artigos na Base de dados de Conhecimento da Microsoft:
290657Descrição das definições do formulário e formulários one-off no Outlook 2002
290659Como atualizar itens existentes para usar um novo formulário personalizado
O código de exemplo a seguir usa o método Items.Add para criar um novo item baseado em um formulário de contato personalizado chamado MyContact.
// TODO: Add code here to start the application.Outlook._Application olApp = new Outlook.ApplicationClass();Outlook._NameSpace olNs = olApp.GetNamespace("MAPI");Outlook.MAPIFolder oContacts = olNs.GetDefaultFolder(Outlook.OlDefaultFolders.olFolderContacts);Outlook._Items oItems = oContacts.Items;Outlook._ContactItem oCustomContact = (Outlook._ContactItem) oItems.Add("IPM.Contact.MyContact");oCustomContact.Display(false);
o seguinte código exemplo usa o método Items.Add para criar um novo item de contato padrão.
// TODO: Add code here to start the application.Outlook._Application olApp = new Outlook.ApplicationClass();Outlook._NameSpace olNs = olApp.GetNamespace("MAPI");Outlook.MAPIFolder oContacts = olNs.GetDefaultFolder(Outlook.OlDefaultFolders.olFolderContacts);Outlook._Items oItems = oContacts.Items;Outlook._ContactItem oContact = (Outlook._ContactItem) oItems.Add("IPM.Contact");oContact.Display(false);
Observação se você usar o método Items.Add , o formulário padrão para a pasta não é importante. Você pode especificar qualquer classe de mensagem válida contanto que a classe da mensagem foi publicada na pasta, na biblioteca de formulários particulares ou na biblioteca de formulários organizacionais.

Método CreateItemFromTemplate

Você pode usar o método CreateItemFromTemplate para criar um novo item que se baseia em um formato de arquivo (.oft) de modelo do Outlook ou em um formato de arquivo (.msg) de mensagem. Porque a maioria dos formulários são publicados em uma pasta ou em uma biblioteca de formulários, esse método não é geralmente usado. No entanto, é aconselhável usar esse método para criar um programa de instalação que é usado para instalar formulários para uma solução do Outlook. Você normalmente faz isso para usuários que não têm acesso à rede ou para usuários que trabalham off-line no Outlook. Você deseja usar o programa de instalação pelos seguintes motivos:
  • O programa de instalação pode ser usado para automatizar o Outlook.
  • O programa de instalação usa o método CreateItemFromTemplate para abrir um formulário personalizado de um compartilhamento de rede ou de um disco.
  • O programa de instalação usa o modelo de objeto do Outlook para publicar o formulário para uso posterior.
// TODO: Add code here to start the application.Outlook._Application olApp = new Outlook.ApplicationClass();Outlook._NameSpace olNs = olApp.GetNamespace("MAPI");Outlook.MAPIFolder oContacts = olNs.GetDefaultFolder(Outlook.OlDefaultFolders.olFolderContacts);Outlook._ContactItem oContact = (Outlook._ContactItem)olApp.CreateItemFromTemplate("C:\\MyContact.oft",oContacts);Outlook.FormDescription oForm = oContact.FormDescription;oForm.Name = "My Contact";oForm.PublishForm(Outlook.OlFormRegistry.olFolderRegistry,oContacts);oContact.Close(Outlook.OlInspectorClose.olSave);

Referenciar itens existentes

Usando o método de itens (i)

Você pode usar o método Usando itens (i) para executar loop em todos os itens em uma pasta. Itens a coleção contém todos os itens em uma pasta específica. Você pode especificar o item que você deseja referenciar, usando um índice com a coleção Items. Isso normalmente é usado com a construção de loop for .

O código de exemplo a seguir usa a abordagem de método de itens (i) para efetuar loop por todos os contatos em contatos do pasta e exibir seu campo NomeCompleto na box.
// TODO: Add code here to start the application.Outlook._Application olApp = new Outlook.ApplicationClass();Outlook._NameSpace olNs = olApp.GetNamespace("MAPI");Outlook.MAPIFolder oContacts = olNs.GetDefaultFolder(Outlook.OlDefaultFolders.olFolderContacts);Outlook.Items oItems = oContacts.Items;for (int i = 1; i <= oItems.Count; i++) {     Outlook._ContactItem oContact = (Outlook._ContactItem) oItems.Item(i);     Console.WriteLine(oContact.FullName);     oContact = null;}

Usando o método Items("Subject")

Você pode usar o método Usando Items("Subject") com a coleção Items. Você fazer isso para especificar uma seqüência de teste que corresponda ao campo assunto de um item.

O código de exemplo a seguir exibe um item na caixa de entrada com uma linha de assunto contém "Você deve ajudar na sexta-feira!"
// TODO: Add code here to start the application.Outlook._Application olApp = new Outlook.ApplicationClass();Outlook._NameSpace olNs = olApp.GetNamespace("MAPI");Outlook.MAPIFolder oInbox = olNs.GetDefaultFolder(Outlook.OlDefaultFolders.olFolderInbox);Outlook.Items oItems = oInbox.Items;Outlook._MailItem oMail = (Outlook._MailItem) oItems.Item ("You must help on Friday!");oMail.Display(false);

O método Find

Você pode usar o método Find para procurar um item em uma pasta. A pesquisa se baseia o valor de um dos campos para o item. Se o método de localização for bem-sucedido, você pode usar o método FindNext para procurar itens adicionais que atendem aos critérios mesmos.

O seguinte exemplo de pesquisas de código para verificar se você tem as tarefas de alta prioridade.
// TODO: Add code here to start the application.Outlook._Application olApp = new Outlook.ApplicationClass();Outlook._NameSpace olNs = olApp.GetNamespace("MAPI");Outlook.MAPIFolder oTasks = olNs.GetDefaultFolder(Outlook.OlDefaultFolders.olFolderTasks);Outlook.Items oItems = oTasks.Items;string sFilter;sFilter = "[Priority] = 'High'";Outlook._TaskItem oTask = (Outlook._TaskItem) oItems.Find(sFilter);if (oTask != null) {     Console.WriteLine("You have work to do.");     Console.WriteLine(oTask.Subject + " is still Pending");}else      Console.Write("Nothing important. Go party.");

Restringir o método

O método Restrict é semelhante ao método Find . No entanto, em vez de retornar um único item, o método Restrict retorna uma coleção de itens que atendem aos critérios de pesquisa. Por exemplo, você pode usar esse método para localizar todos os contatos que trabalham para a mesma empresa.

O seguinte código de exemplo grava a propriedade FullName de todos os contatos que trabalham para a. Datum Corporation.
// TODO: Add code here to start the application.Outlook._Application olApp = new Outlook.ApplicationClass();Outlook._NameSpace olNs = olApp.GetNamespace("MAPI");Outlook.MAPIFolder oContacts = olNs.GetDefaultFolder(Outlook.OlDefaultFolders.olFolderContacts);Outlook.Items oItems = oContacts.Items;string sFilter;sFilter = "[Company] = 'A. Datum Corporation'";Outlook.Items oRestrictedItems = oItems.Restrict(sFilter);for (int i=1 ;i<=oRestrictedItems.Count;i++) {   Outlook._ContactItem oContactItem = (Outlook._ContactItem) oRestrictedItems.Item(i);   Console.WriteLine(oContactItem.FullName);   oContactItem = null; }

Método GetItemFromID

Você pode usar o método GetItemFromID em soluções mais complexas em que você deseja que a solução para controlar o campo EntryID e o campo de identificação de armazenamento de um item. Você deseja fazer isso para que o item pode ser rapidamente referenciado mais tarde. Para obter informações adicionais, consulte o artigo 293152 na seção "Referências".
Referências
Para obter mais informações sobre como usar o GetFolderFromID método, clique no número abaixo para ler o artigo na Base de dados de Conhecimento da Microsoft:
293152Programando com EntryIDs e StoreIDs
pasta de itens do Outlook 2002

Propriedades

ID do Artigo: 310244 - Última Revisão: 12/07/2015 08:00:00 - Revisão: 5.5

Microsoft Office Outlook 2003, Microsoft Outlook 2002 Standard Edition, Microsoft Visual C# .NET 2003 Standard Edition, Microsoft Visual C# .NET 2002 Standard Edition

  • kbnosurvey kbarchive kbmt kboutlookobj kbcode kbhowto KB310244 KbMtpt
Comentários