TableView.GetTable-Methode (Outlook)

Gibt ein Table -Objekt zurück, das alle Microsoft Outlook-Elemente darstellt, die in einem TableView -Objekt enthalten sind.

Syntax

Ausdruck. GetTable

Ausdruck Eine Variable, die ein TableView-Objekt darstellt.

Rückgabewert

Eine Tabelle, deren Zeilen Elemente in der aktuellen Tabellenansicht darstellen.

HinwBemerkungeneise

Die GetTable -Methode des TableView -Objekts gibt eine Tabelle mit Elementen aus einem oder mehreren Ordnern im selben oder mehreren Informationsspeichern, in einer aggregierten Ansicht zurück. Beispiel einer aggregierten Ansicht durch eine Suche über alle e-Mail-Elemente mithilfe der Sofortsuche abgerufen. Dieses Verhalten weicht von der GetTable -Methode des Folder -Objekts, der ein Table-Objekt abgerufen wird, die Elemente im gleichen Ordner enthält.

Das übergeordnete TableView -Objekt muss auf dem aktuellen Ordner des aktiven Explorers, basieren, wie die CurrentFolder -Eigenschaft des aktiven Explorer -Objekt angegeben. Wenn der Ordner keinen aktuellen Ordner eines Explorers sichtbar ist, oder die Ansicht des Ordners, der durch die Folder.CurrentView -Eigenschaft angegeben wird, keiner Tabelle ist, gibt Outlook einen Fehler zurück.

Der Filter für die resultierende Tabelle wird von der Filter -Eigenschaft des TableView -Objekts festgelegt. Wenn die Filter -Eigenschaft des TableView -Objekts nicht leer ist, gibt GetTable ein Table -Objekt mit Zeilen, die die gefilterte Teilmenge der Elemente in der Ansicht darstellen. Wenn Sie anschließend auf die resultierende Tabelle die Table.Restrict -Methode aufgerufen wird, entspricht die Restrict -Methode anwenden eine Operation mit dem Filter durch TableView.Filter dargestellt.

GetTable gibt eine Tabelle mit den standardspaltensammlung zurück. GetTable gibt keine Tabelle zurück, die Spalten für jedes Feld in der ViewFields -Auflistung der aktuellen Ansicht enthält. Weitere Informationen zum Standardspaltensatz einer Tabelle auf der Grundlage des Ordnertyps finden Sie unter In einem Tabellenobjekt angezeigte Standardeigenschaften. Verwenden Sie die Methoden Add, Remove oder RemoveAll des Columns -Auflistungsobjekts, um die standardspaltensammlung zu ändern. Eigenschaften, die Sie einer Tabelle nicht hinzufügen können, da Spalten unter Nicht unterstützte Eigenschaften in einem Tabellenobjekt oder Tabellenfilter aufgeführt sind.

Die Reihenfolge der Zeilen in der Ergebnistabelle ist nicht unbedingt identisch mit der Reihenfolge der Elemente in der aktuellen Ansicht auf der GetTable basiert. Beispielsweise gibt GetTable keine Tabelle mit einer Zeile zurück, die eine Gruppe von Kopfzeile in der Ansicht darstellt. Verwenden Sie zum Sortieren der Zeilen in der Tabelle GetTable zurückgegebenes der Sort -Methode des Table -Objekts.

Das übergeordnete Objekt des Table -Objekts zurückgegebenen GetTable ist das TableView -Objekt. Das übergeordnete Objekt des TableView -Objekts ist die Views -Auflistung und das übergeordnete Objekt der Views -Auflistung ist das Folder -Objekt.

Beispiel

Der folgende verwaltete Code ist in C# geschrieben. Um ein verwaltetes Codebeispiel von .NET Framework auszuführen, das ein Component Object Model (COM) aufrufen muss, müssen Sie eine Interopassembly verwenden, die verwaltete Schnittstellen definiert und den COM-Objekten in der Object Model-Typbibliothek zuordnet. Für Outlook können Sie Visual Studio und die Outlook Primary Interop Assembly (PIA) verwenden. Stellen Sie sicher, dass Sie die Outlook 2013 PIA installiert und eine Referenz zur Microsoft Outlook 15.0-Objektbibliothekkomponente in Visual Studio hinzugefügt haben, bevor Sie verwaltete Codebeispiele für Outlook 2013 ausführen. Sie sollten den folgenden Code in der ThisAddIn Klasse eines Outlook-Add-Ins verwenden (mit Office Developer Tools für Visual Studio). Das Objekt der Anwendung im Code muss ein vertrauenswürdiges Outlook- Anwendungsobjekt sein, das von ThisAddIn.Globals bereitgestellt wird. Weitere Informationen zur Verwendung der Outlook-PIA zur Entwicklung verwalteter Outlook-Lösungen finden Sie auf MSDN unter Willkommen bei der Referenz zur primären Interopassembly von Outlook (PIA).

Im folgenden Codebeispiel wird ein Table -Objekt aus der aktuellen Ansicht des Ordners Posteingang abgerufen. Im Codebeispiel wird den aktuellen Ordner des aktiven Explorers auf den Posteingang, und klicken Sie dann überprüft, ob die aktuelle Ansicht des Posteingangs einer Tabellenansicht ist. Nach Sicherstellung diese zwei mögliche Ursachen, das Codebeispiel die TableView.GetTable -Methode aufgerufen und zeigt alle Elemente, die von jeder Zeile im zurückgegebenen Tabelle dargestellt.

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"]); 
 } 
 } 
} 

Siehe auch

TableView-Objekt

Wie: Suchen und Abrufen von Elementen in einer aggregierten Ansicht

Support und Feedback

Haben Sie Fragen oder Feedback zu Office VBA oder zu dieser Dokumentation? Unter Office VBA-Support und Feedback finden Sie Hilfestellung zu den Möglichkeiten, wie Sie Support erhalten und Feedback abgeben können.