DataTableNavigator.DataHeaderFields 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 the text of the header fields of the control. Read/write.

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

Syntax

'Declaration
<PersistenceModeAttribute(PersistenceMode.Attribute)> _
<SRCategoryAttribute("Category_Data")> _
<DefaultValueAttribute(Nothing)> _
<MergablePropertyAttribute(False)> _
<TypeConverterAttribute("Microsoft.Speech.Web.UI.Design.ListConverter")> _
<SRDescriptionAttribute("DataTableNavigator_DataHeaderFields")> _
Public Property DataHeaderFields As StringArrayList

[PersistenceModeAttribute(PersistenceMode.Attribute)] 
[SRCategoryAttribute("Category_Data")] 
[DefaultValueAttribute(null)] 
[MergablePropertyAttribute(false)] 
[TypeConverterAttribute("Microsoft.Speech.Web.UI.Design.ListConverter")] 
[SRDescriptionAttribute("DataTableNavigator_DataHeaderFields")] 
public StringArrayList DataHeaderFields { get; set; }

Remarks

The following table shows several fields of a data source containing weather data. To present this data with a DataTableNavigator control, its DataHeaderFields property is an array containing the data field names City and State. Each time the control navigates to an element of this data, it collects the contents of the City and State fields in the element, concatenates them, and speaks them.

City	State	Low	High	Condition
Seattle	Washington	53	76	Cloudy
Olympia	Washington	62	74	Rain
Spokane	Washington	47	82	Clear

If the DataHeaderFields property contains duplicate field names, the control throws an ArgumentException.

Example

<form id="Form1" method="post" runat="server">
  ...
    <asp:textbox id="TextBox1" runat="server"></asp:textbox>
    <speech:semanticmap id="SemanticMap1" runat="server" >
      <speech:SemanticItem id="SemItemNav" runat="server" 
        TargetElement="TextBox1" TargetAttribute="value" BindOnChanged="True">
      </speech:SemanticItem>
    </speech:semanticmap>

    <speech:DataTableNavigator 
      id="Navigator1"  
      QuestionPrompt="weather by state" 
      DataHeaderFields="city,state"
      DataContentFields="low,high,conditions" 
      EndSilence="2500" 
      AccessMode="Select" 
      ShortInitialTimeout="2000" 
      SemanticItem="SemItemNav"
      runat="server">
    </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