SrgsText Classe

Definição

public ref class SrgsText : System::Speech::Recognition::SrgsGrammar::SrgsElement

public class SrgsText : System.Speech.Recognition.SrgsGrammar.SrgsElement

[System.Serializable]
public class SrgsText : System.Speech.Recognition.SrgsGrammar.SrgsElement

type SrgsText = class
    inherit SrgsElement

[<System.Serializable>]
type SrgsText = class
    inherit SrgsElement

Public Class SrgsText
Inherits SrgsElement

Herança

Object

MarshalByRefObject

SrgsElement

SrgsText

Atributos

SerializableAttribute

Exemplos

O exemplo seguinte de código C# demonstra como usar a SrgsText classe para modificar o conteúdo textual dos SrgsItem objetos. O exemplo altera os valores iniciais do texto dos SrgsItem objetos (Large, Larger, e Largest) para Small, Medium, e Large, respetivamente.

// Create SrgsItem objects and specify their text.
SrgsItem smallItem = new SrgsItem("Large");
SrgsItem mediumItem = new SrgsItem("Larger");
SrgsItem largeItem = new SrgsItem("Largest");

SrgsText textOfItem = null;

//  Change the text of smallItem.
if (smallItem.Elements[0] is SrgsText)
{
  textOfItem = smallItem.Elements[0] as SrgsText;
  textOfItem.Text = "Small";
}

//  Change the text of mediumItem.
if (mediumItem.Elements[0] is SrgsText)
{
  textOfItem = mediumItem.Elements[0] as SrgsText;
  textOfItem.Text = "Medium";
}

// Change the text of largeItem.
if (largeItem.Elements[0] is SrgsText)
{
  textOfItem = largeItem.Elements[0] as SrgsText;
  textOfItem.Text = "Large";
}

// Create an SrgsOneOf object and add smallItem, mediumItem,
// and largeItem as alternatives.
SrgsOneOf itemSize = new SrgsOneOf(new SrgsItem[]
  { smallItem, mediumItem, largeItem });

// Create a new SrgsRule from the SrgsOneOf object, and specify its identifier.
SrgsRule size = new SrgsRule("Sizes", itemSize);

// Create an SrgsDocument object.
// Add the SrgsRule object to the collection of rules and make it the root rule.
SrgsDocument document = new SrgsDocument();
document.Rules.Add(size);
document.Root = size;

// Write the SrgsDocument to an XML grammar file.
string srgsDocumentFile = Path.Combine(Path.GetTempPath(), "srgsDocumentFile.xml");
XmlWriter writer = XmlWriter.Create(srgsDocumentFile);
document.WriteSrgs(writer);
writer.Close();

O seguinte mostra como o texto modificado dos SrgsItem objetos apareceria como item elementos no ficheiro de gramática XML de saída.

<!-- SRGS XML Fragment -->
<one-of>
  <item>Small</item>
  <item>Medium</item>
  <item>Large</item>
</one-of>

Observações

A SrgsText classe representa o texto encontrado dentro de um conjunto de etiquetas de elementos SRGS. Quando um SrgsItem objeto é construído com um String parâmetro, um SrgsText objeto é criado com a sua Text propriedade inicializada ao valor desse parâmetro. O Text objeto é então adicionado à Elements coleção sobre o SrgsItem objeto.

Ver também

• SrgsItem