Row Interface

Definition

Represents a row of data in the Table object.

public interface class Row : Microsoft::Office::Interop::Outlook::_Row
[System.Runtime.InteropServices.Guid("000630D3-0000-0000-C000-000000000046")]
public interface Row : Microsoft.Office.Interop.Outlook._Row
Public Interface Row
Implements _Row
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 _Row.

A Table is composed of rows and columns. It represents a read-only dynamic rowset of data in a Folder or Search object. You can regard each row of a Table as an item in the folder, and each column as a property of the item. By default, the Table contains only a subset of properties for items in the folder. This makes the Table an in-memory lightweight rowset that supports fast enumeration and filtering of items in the folder.

If the Table object is obtained from GetTable(Object, Object), you can further specify a filter (in Restrict(String)) to obtain a more restricted set of rows in the Table.

You can use the Table methods: FindRow(String), FindNextRow(), GetNextRow(), and MoveToStart() to obtain a specific row in a Table.

Use GetValues() to obtain an array of values that correspond to column values at that row in the Table.

Use the helper functions BinaryToString(Object), LocalTimeToUTC(Object), and UTCToLocalTime(Object) to facilitate type conversion of column values at a specific row. For more information on property value representation in a Table, see Factors Affecting Property Value Representation in the Table and View Classes

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.

Properties

Application

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

(Inherited from _Row)
Class

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

(Inherited from _Row)
Item[Object]

Obtains an Object that represents the value for the Row object at the column specified by Index.

(Inherited from _Row)
Parent

Returns the parent object of the Row object. Read-only.

(Inherited from _Row)
Session

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

(Inherited from _Row)

Methods

BinaryToString(Object)

Obtains a String (string in C#) representing a value that has been converted from a binary value for the parent Row at the column specified by Index.

(Inherited from _Row)
GetValues()

Obtains a one-dimensional array containing the values for all columns at the Row in the parent Table.

(Inherited from _Row)
LocalTimeToUTC(Object)

Obtains a DateTime value in a Table specified by the Row object at Index, that has been converted from local time to Coordinated Universal Time (UTC).

(Inherited from _Row)
UTCToLocalTime(Object)

Obtains a DateTime value in a Table specified by the Row object at Index, that has been converted from Coordinated Universal Time (UTC) to local time.

(Inherited from _Row)

Applies to