_Table.FindRow(String) Method

Reference

Definition

Namespace:: Microsoft.Office.Interop.Outlook

Assembly:: Microsoft.Office.Interop.Outlook.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

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

public:
 Microsoft::Office::Interop::Outlook::Row ^ FindRow(System::String ^ Filter);

public Microsoft.Office.Interop.Outlook.Row FindRow (string Filter);

Public Function FindRow (Filter As String) As Row

Parameters

Filter: String

Specifies the condition that a row in the Table has to meet.

Returns

Row

A Row object that represents the first row in the Table that meets the filter criteria. Returns Nothing (a null reference (Nothing in Visual Basic) in C#) if no such row can be found, or the Table does not contain any rows.

Remarks

FindRow always starts from the first row in the Table.

FindRow returns Nothing (a null reference (Nothing in Visual Basic) in C#) if a property in Filter does not exist in the specified namespace. The property is considered a named property in the MAPI property set, PS_PUBLIC_STRINGS. FindRow does not return an error in this case.

FindRow returns an error if Filter is a blank string or an invalid restriction. In cases where FindRow does not find any row, the current row will not be repositioned to where it was before the call to FindRow.

To use content indexing search in a Table, use the Restrict(String) method. FindRow returns an error if Filter contains content indexing keywords.

Applies to