Table Interface

Definition

Represents a set of item data from a Folder or Search object, with items as rows of the table and properties as columns of the table.

public interface class Table : Microsoft::Office::Interop::Outlook::_Table
[System.Runtime.InteropServices.Guid("000630D2-0000-0000-C000-000000000046")]
public interface Table : Microsoft.Office.Interop.Outlook._Table
Public Interface Table
Implements _Table
Derived
Attributes
Implements

Remarks

This is a .NET interface derived from a COM coclass that is required by managed code for interoperability with the corresponding COM object. Use this derived interface to access all method, property, and event members of the COM object. However, if a method or event you want to use shares the same name under the same COM object, cast to the corresponding primary interface to call the method, and cast to the latest events interface to connect to the event. Refer to this topic for information about the COM object. For information about the method and property members of the COM object, see _Table.

The Table represents a read-only dynamic rowset of data in a Folder or Search object. You can use GetTable(Object, Object) or GetTable() to obtain a Table object that represents a set of items in a folder or search folder. If the Table object is obtained from Folder.GetTable, you can further specify a filter (in Restrict(String)) to obtain a subset of the items in the folder. If you do not specify any filter, you will obtain all the items in the folder.

By default, each item in the returned Table contains only a default subset of its properties. You can regard each row of a Table as an item in the folder, each column as a property of the item, and the Table as an in-memory lightweight rowset that allows fast enumeration and filtering of items in the folder. Although additions and deletions of the underlying folder are reflected by the rows in the Table, the Table does not support any events for adding, changing, and removing of rows. If you require a writeable object from the Table row, obtain the Entry ID for that row from the default EntryID column in the Table and then use the GetItemFromID(String, Object) method of the NameSpace object to obtain a full item, such as a MailItem or a ContactItem, that supports read-write operations. For more information on default columns in a Table, see Default Properties Displayed in a Table Object.

For more information on the Table object, see Enumerating, Searching, and Filtering Items in a Folder.

Properties

Application

Returns an Application object that represents the parent application (Outlook) for the Table object. Read-only.

(Inherited from _Table)
Class

Returns a constant in the OlObjectClass enumeration indicating the class of the Table object. Read-only.

(Inherited from _Table)
Columns

Returns a Columns collection object that contains the columns defined for the Table. Read-only.

(Inherited from _Table)
EndOfTable

Returns a Boolean (bool in C#) that indicates whether the current row is positioned after the last row in the Table object. Read-only.

(Inherited from _Table)
Parent

Returns the parent Object of the Table object. Read-only.

(Inherited from _Table)
Session

Returns the NameSpace object for the current session. Read-only.

(Inherited from _Table)

Methods

FindNextRow()

Finds the next row in the Table that meets the criteria specified in a preceding FindRow(String).

(Inherited from _Table)
FindRow(String)

Finds the first row in the Table that meets the criteria specified in Filter.

(Inherited from _Table)
GetArray(Int32)

Obtains a two-dimensional array that contains a set of row and column values from the Table.

(Inherited from _Table)
GetNextRow()

Moves the current row to the next row in the Table and obtains that row in the Table.

(Inherited from _Table)
GetRowCount()

Obtains the number of rows in the Table.

(Inherited from _Table)
MoveToStart()

Moves the current row of the Table to just before the first row of the Table.

(Inherited from _Table)
Restrict(String)

Applies a filter to the rows in the Table and obtains a new Table object.

(Inherited from _Table)
Sort(String, Object)

Sorts the rows of the Table by the property specified in SortProperty and resets the current row to just before the first row in the Table.

(Inherited from _Table)

Applies to