ContactSearchResultList Control

Use the ContactSearchResultList control in Microsoft Lync 2010 Control applications to display the result of a search performed by the ContactSearchInputBox control.

The ContactSearchResultList control is intended to be used with and bound to a ContactSearchInputBox control. To bind a ContactSearchResultList control to a ContactSearchInputBox control, bind the properties as shown in the code sample later in this topic. The ContactSearchResultList control gets its results collection from the ContactSearchInputBox control.

The ContactSearchInputBox and ContactSearchResultList controls, while related, are designed as separate controls to allow the developer to display search results and search input in separate locations on a page.


Notable ContactSearchResultList control public properties that are related to unified communications appear in the following table. For more information, see Lync 2010 Class Libraries References.




Gets or sets a SearchState enumeration representing the search status. Possible values:

  • Cleared

  • Searching

  • Finished

  • Error


Gets or sets a SearchType enumeration representing the search type. Possible values:

  • Name

  • Skill


Gets or sets a data structure which contains information used to customize the information that accompanies messages. For more information on the use of contextual information, see the topics listed at Lync Extensibility API Contextual Conversations (Lync 2010 SDK).


Gets or sets a bool value that determines whether contacts in the list display as friendly name or URI.


Gets or sets the DataTemplate used to render a bot item.


Gets or sets the DataTemplate used to render a group item.


Gets or sets the DataTemplate used to render a person item.


Gets or sets the DataTemplate used to render a telephone item.


This property specifies a collection that is used to generate the content of the ContactSearchResultList control. In typical applications, ContactSearchResultList is intended to display the results of a search that is performed using a ContactSearchInputBox control that appears elsewhere on the page. As shown in the following code example, to establish the connection between these controls, you should bind ItemsSource to the Results property of the ContactSearchInputBox control.

The following example can be used for Silverlight and WPF application development.

  <controls:ContactSearchInputBox x:Name="searchInput"/>
    ItemsSource="{Binding Results, ElementName=searchInput, Mode=OneWay}"
    ResultsState="{Binding SearchState, ElementName=searchInput, Mode=OneWay}"/>