Método TableView.GetTable (Outlook)

Retorna um objeto Table que representa todos os itens do Microsoft Outlook contidos em um objeto TableView.

Sintaxe

expression. GetTable

Expressão Uma variável que representa um objeto TableView .

Valor de retorno

Uma tabela cujas linhas representam itens no modo de exibição de tabela atual.

Comentários

O método GetTable do objeto TableView retorna uma tabela de itens de uma ou mais pastas no mesmo armazenamento ou distribuindo sobre repositórios de vários, em uma exibição agregada. Por exemplo, uma exibição agregada obtida por uma pesquisa em todos os itens de email usando a pesquisa instantânea. Esse comportamento difere do método GetTable do objeto Folder, que obtém um objeto table que contém itens da mesma pasta.

O objeto TableView pai deve se basear na pasta atual do explorer ativo, conforme indicado pela propriedade CurrentFolder do objeto Explorer ativo. Se a pasta não for uma pasta atual de um explorer visível ou se o modo de exibição nessa pasta, o que é indicado pela propriedade Folder.CurrentView, não é um modo de exibição de tabela, o Outlook retornará um erro.

O filtro para a tabela resultante é definido pela propriedade filtro do objeto TableView. Se a propriedade Filter do objeto TableView não está vazia, GetTable retorna um objeto Table com linhas que representam um subconjunto de itens disponíveis no modo de exibição filtrado. Se subsequentemente, o método Restrict for chamado na tabela resultante, aplicar o método Restrict é equivalente a uma operação AND lógica com o filtro representado por TableView.Filter.

GetTable retorna uma tabela com o conjunto de coluna padrão. GetTable não retorna uma tabela que contém colunas para cada campo na coleção ViewFields de modo de exibição atual. Para obter mais informações sobre o conjunto de colunas padrão de uma tabela baseada no tipo de pasta, consulte Propriedades padrão exibidas em um objeto de tabela. Para modificar o conjunto de coluna padrão, use os métodos Add, Remove ou RemoveAll do objeto da coleção Columns. As propriedades que você não pode adicionar a uma tabela como colunas são listadas em Propriedades sem suporte em um objeto de tabela ou filtro de tabela.

A ordem das linhas da tabela resultante não é garantida para ser o mesmo que a ordem dos itens na exibição atual no qual GetTable se baseia. Por exemplo, GetTable não retorna uma tabela com uma linha que representa um cabeçalho de agrupar por no modo de exibição. Para classificar as linhas na tabela retornado da GetTable, use o método Sort do objeto Table.

O objeto pai do objeto Table retornado pela GetTable é o objeto TableView. O objeto pai do objeto TableView é o conjunto de modos de exibição e o objeto pai da coleção Views é o objeto Folder.

Exemplo

The following managed code is written in C#. To run a .NET Framework managed code sample that needs to call into a Component Object Model (COM), you must use an interop assembly that defines and maps managed interfaces to the COM objects in the object model type library. For Outlook, you can use Visual Studio and the Outlook Primary Interop Assembly (PIA). Before you run managed code samples for Outlook 2013, ensure that you have installed the Outlook 2013 PIA and have added a reference to the Microsoft Outlook 15.0 Object Library component in Visual Studio. Você deve usar o código a ThisAddIn seguir na classe de um suplemento do Outlook (usando ferramentas de desenvolvedor do Office para Visual Studio). The Application object in the code must be a trusted Outlook Application object provided by ThisAddIn.Globals. For more information about using the Outlook PIA to develop managed Outlook solutions, see the Outlook 2013 Primary Interop Assembly Reference on MSDN.

O exemplo de código a seguir obtém um objeto Table do modo de exibição atual da pasta caixa de entrada. O exemplo de código define a pasta atual do explorer ativo à caixa de entrada e, em seguida, verifica se o modo de exibição atual da caixa de entrada é um modo de exibição de tabela. Após assegurando essas duas condições, o código de exemplo chama o método TableView.GetTable e exibe cada item representado por cada linha na tabela retornada.

private void DemoViewGetTable() 
{ 
 // Obtain the Inbox folder. 
 Outlook.Folder inbox = 
 Application.Session.GetDefaultFolder( 
 Outlook.OlDefaultFolders.olFolderInbox) 
 as Outlook.Folder; 
 
 // Set ActiveExplorer.CurrentFolder to Inbox. 
 // Inbox must be the current folder 
 // for TableView.GetTable to work correctly. 
 Application.ActiveExplorer().CurrentFolder = inbox; 
 
 // Ensure that the current view is a table view. 
 if (inbox.CurrentView.ViewType == 
 Outlook.OlViewType.olTableView) 
 { 
 Outlook.TableView view = 
 inbox.CurrentView as Outlook.TableView; 
 
 // No arguments are needed for View.GetTable. 
 Outlook.Table table = view.GetTable(); 
 
 Debug.WriteLine("View Count=" 
 + table.GetRowCount().ToString()); 
 while (!table.EndOfTable) 
 { 
 // First row in Table. 
 Outlook.Row nextRow = table.GetNextRow(); 
 Debug.WriteLine(nextRow["Subject"] 
 + " Modified: " 
 + nextRow["LastModificationTime"]); 
 } 
 } 
} 

Confira também

Objeto TableView

Como: pesquisar e obter itens em uma exibição agregada

Suporte e comentários

Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.