Método TableView.GetTable (Outlook)
Devuelve un objeto Table que representa todos los elementos de Microsoft Outlook que están contenidos en un objeto TableView.
Sintaxis
expresión. GetTable
Expresión Variable que representa un objeto TableView .
Valor devuelto
Una tabla cuyas filas representan los elementos de la vista de tabla actual.
Comentarios
El método GetTable del objeto TableView devuelve un objeto table de elementos de una o varias carpetas en el mismo almacén o de varios almacenes, en una vista agregada. Por ejemplo, una vista agregada obtenida por una búsqueda en todos los elementos de correo mediante el uso de la búsqueda instantánea. Este comportamiento se diferencia del método GetTable del objeto Folder, que obtiene un objeto table que contiene los elementos de la misma carpeta.
El objeto TableView primario debe basarse en la carpeta actual del explorador activo, como se indica en la propiedad CurrentFolder del objeto Explorer activo. Si la carpeta no es una carpeta actual de un explorador visible, o si la vista de esa carpeta, que se indica mediante la propiedad Folder.CurrentView, no es una vista de tabla, Outlook devuelve un error.
El filtro para la tabla resultante se establece mediante la propiedad Filter del objeto TableView. Si la propiedad Filter del objeto TableView no está vacía, GetTable devuelve un objeto Table con las filas que representan el subconjunto de elementos disponibles en la vista filtrado. Si posteriormente, se llama al método Table.Restrict en la tabla resultante, al aplicar el método Restrict es equivalente a una operación de AND lógica con el filtro representado por TableView.Filter.
GetTable devuelve una tabla con el conjunto de columnas predeterminado. GetTable no devuelve una tabla que contiene columnas para cada campo de la colección ViewFields de la vista actual. Para obtener más información sobre el conjunto de columnas predeterminado de una tabla basada en el tipo de carpetas, vea el tema sobre las propiedades predeterminadas mostradas en un objeto Table. Para modificar el conjunto de columnas predeterminado, use los métodos de Agregar, Quitar o RemoveAll del objeto de colección Columns. Las propiedades que no se pueden agregar a una tabla como columnas se enumeran en Propiedades no admitidas en un objeto Table o filtro de tabla.
El orden de filas en la tabla resultante no se garantiza que sea el mismo que el orden de los elementos de la vista actual en el que se basa GetTable. Por ejemplo, GetTable no devuelve una tabla con una fila que representa un encabezado Agrupar por en la vista. Para ordenar las filas de la tabla devuelta desde GetTable, utilice el método Sort del objeto Table.
El objeto primario del objeto Table devuelto por GetTable es el objeto TableView. El objeto primario del objeto TableView es la colección Views y el objeto primario de la colección Views es el objeto Folder.
Ejemplo:
El siguiente ejemplo de código administrado está escrito en C#. Para ejecutar un ejemplo de código administrado de .NET Framework que necesita llamar un modelo de objetos componentes (COM), debe utilizar un ensamblado de interoperabilidad que defina y asigne interfaces administradas a los objetos COM de la biblioteca de tipos de modelos de objetos. Para Outlook, puede utilizar Visual Studio y el ensamblado de interoperabilidad primario (PIA) de Outlook. Antes de ejecutar ejemplos de código administrado para Outlook 2013, compruebe que tiene el PIA de Outlook 2013 instalado y que ha añadido una referencia al componente biblioteca de objetos de Microsoft Outlook 15.0 en Visual Studio. Debe usar el código siguiente en la ThisAddIn clase de un complemento de Outlook (con Office Developer Tools para Visual Studio). El objeto Application del código debe ser un objeto Application de Outlook de confianza proporcionado por ThisAddIn.Globals. Si desea más información sobre el uso del PIA de Outlook para desarrollar soluciones de Outlook administradas, consulte Outlook 2013 Primary Interop Assembly Reference en MSDN.
En el ejemplo de código siguiente se obtiene un objeto Table de la vista actual de la carpeta Bandeja de entrada. El ejemplo de código establece la carpeta actual del explorador activo a la Bandeja de entrada y, a continuación, comprueba que la vista actual de la Bandeja de entrada es una vista de tabla. Después de lo que asegura que estas dos condiciones, el ejemplo de código llama al método TableView.GetTable y muestra cada elemento representado por cada fila de la tabla de devuelto.
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"]);
}
}
}
Consulte también
Cómo: buscar y obtener elementos en una vista agregada
Soporte técnico y comentarios
¿Tiene preguntas o comentarios sobre VBA para Office o esta documentación? Vea Soporte técnico y comentarios sobre VBA para Office para obtener ayuda sobre las formas en las que puede recibir soporte técnico y enviar comentarios.