DataTableNavigator.DataMember Property

Article
08/18/2014

This content is no longer actively maintained. It is provided as is, for anyone who may still be using these technologies, with no warranties or claims of accuracy with regard to the most recent product version or service release.

Gets or sets a data member from a multimember DataSource object. Read/write.

Namespace: Microsoft.Speech.Web.UI
Assembly: Microsoft.Speech.Web (in microsoft.speech.web.dll)

Syntax

'Declaration
<SRDescriptionAttribute("All_DataMember")> _
<SRCategoryAttribute("Category_Data")> _
<BindableAttribute(True)> _
<DefaultValueAttribute("")> _
Public Property DataMember As String

[SRDescriptionAttribute("All_DataMember")] 
[SRCategoryAttribute("Category_Data")] 
[BindableAttribute(true)] 
[DefaultValueAttribute("")] 
public string DataMember { get; set; }

Remarks

Use the DataMember property to specify a member from a multimember data source to bind to the list control. For example, if the DataSource property specifies a data source with more than one table, use the DataMember property to specify the table. For more information about ASP.NET data binding, see Accessing Data with ASP.NET.

The resolved data source (the DataSource and DataMember properties) must be of one of the following types:

An array.
An object that implements IList and has a strongly typed Item property. To strongly type the Item property, define its default implementation as private. To create an IList object that follows the rules of a strongly typed collection, derive from CollectionBase.
An object that implements ITypedList.

For more information, see the section titled Generic Collection Types in the .NET Framework Developer's Guide.

Example

The following example is adapted from the Speech ServerTableNavigation sample.

<form id="Form1" method="post" runat="server">
  ...
  <speech:DataTableNavigator id="Navigator1" runat="server" 
    DataSource="{OPEN_ASP_TAG}# dataSet11 {CLOSE_ASP_TAG}"
    DataMember="CityInfo" 
    InitialTimeout="3000" 
    ShortInitialTimeout="500"
    MaxTimeout="30000" 
    DataContentFields="High,Low,Sky Condition"     
    QuestionPrompt="Next Command?" 
    PromptSelectFunction="promptSelectFunction" 
    DataHeaderFields="City"     
    SemanticItem="siDataTableNavigator">
    <CommandRules>
      <speech:CommandRule Type="First"></speech:CommandRule>
      <speech:CommandRule Type="Last"></speech:CommandRule>
      <speech:CommandRule Type="Exit"></speech:CommandRule>
      <speech:CommandRule Type="Next"></speech:CommandRule>
      <speech:CommandRule Type="Previous"></speech:CommandRule>
      <speech:CommandRule Type="Select" Active="False"></speech:CommandRule>
      <speech:CommandRule Type="Header" Active="False"></speech:CommandRule>
      <speech:CommandRule Type="Read"></speech:CommandRule>
    </CommandRules>
  </speech:DataTableNavigator>
  ...
</form>

Thread Safety

All public static (Shared in Visual Basic) members of this type are thread-safe. Instance members are not guaranteed to be thread-safe.

Platforms

Development Platforms

Windows XP Professional with Service Pack 2 (SP2), Windows Server 2003, Windows Vista Ultimate Edition, Windows Vista Business Edition, Windows Vista Enterprise Edition

Target Platforms

Windows Server 2003

Share via