Поделиться через


GrammarBuilder.Add Метод

Определение

Создает новый объект GrammarBuilder, содержащий последовательность из двух элементов грамматики.

Перегрузки

Add(Choices, GrammarBuilder)

Создает элемент GrammarBuilder, содержащий объект Choices, за которым следует объект GrammarBuilder.

Add(GrammarBuilder, Choices)

Создает элемент GrammarBuilder, содержащий объект GrammarBuilder, за которым следует объект Choices.

Add(GrammarBuilder, GrammarBuilder)

Создает новый объект GrammarBuilder, содержащий последовательность из двух объектов GrammarBuilder.

Add(GrammarBuilder, String)

Создает новый объект GrammarBuilder, содержащий объект GrammarBuilder, после которого следует фраза.

Add(String, GrammarBuilder)

Создает новый объект GrammarBuilder, содержащий фразу, после которой следует объект GrammarBuilder.

Комментарии

Статические Add методы предоставляют еще один механизм, с помощью которого можно объединять различные типы для создания разнообразия и гибкости в грамматиках, созданных с помощью GrammarBuilder. Эти методы соответствуют статическим Addition методам, которые также определены в GrammarBuilder классе . Порядок параметров определяет порядок элементов в новом GrammarBuilderобъекте .

Объект GrammarBuilder также можно получить из Choicesобъектов , SemanticResultKey, SemanticResultValueи String . Дополнительные сведения см. в операторах Implicit и Addition .

Важно!

Распознаватель речи может вызвать исключение при использовании грамматики распознавания речи, содержащей повторяющиеся семантические элементы с тем же именем ключа или несколько семантических элементов, которые могут многократно изменять значение одного и того же семантического элемента.

Дополнительные сведения о построении и использовании грамматики распознавания речи см. в разделе Распознавание речи.

Add(Choices, GrammarBuilder)

Исходный код:
GrammarBuilder.cs
Исходный код:
GrammarBuilder.cs
Исходный код:
GrammarBuilder.cs

Создает элемент GrammarBuilder, содержащий объект Choices, за которым следует объект GrammarBuilder.

public:
 static System::Speech::Recognition::GrammarBuilder ^ Add(System::Speech::Recognition::Choices ^ choices, System::Speech::Recognition::GrammarBuilder ^ builder);
public static System.Speech.Recognition.GrammarBuilder Add (System.Speech.Recognition.Choices choices, System.Speech.Recognition.GrammarBuilder builder);
static member Add : System.Speech.Recognition.Choices * System.Speech.Recognition.GrammarBuilder -> System.Speech.Recognition.GrammarBuilder
Public Shared Function Add (choices As Choices, builder As GrammarBuilder) As GrammarBuilder

Параметры

choices
Choices

Первый элемент grammar, представляющий набор альтернатив.

builder
GrammarBuilder

Второй элемент grammar.

Возвращаемое значение

Объект GrammarBuilder для последовательности элементов choices, за которой следует элемент builder.

Комментарии

GrammarBuilder поддерживает неявные преобразования из следующих классов:

Этот метод принимает указанные выше объекты для builder параметра .

Дополнительные сведения см. в операторах Implicit и Addition .

Важно!

При объединении Choices и GrammarBuilder объектов, содержащих SemanticResultValue экземпляры или SemanticResultKey , избегайте создания повторяющихся семантических элементов с одинаковым именем ключа или нескольких семантических элементов, которые могут многократно изменять Value свойство SemanticValue объекта. Распознаватель речи может вызвать исключение, если он сталкивается с этими обстоятельствами. Дополнительные сведения о создании грамматики распознавания речи, содержащей семантические сведения, см. в статье Добавление семантики в грамматику GrammarBuilder.

См. также раздел

Применяется к

Add(GrammarBuilder, Choices)

Исходный код:
GrammarBuilder.cs
Исходный код:
GrammarBuilder.cs
Исходный код:
GrammarBuilder.cs

Создает элемент GrammarBuilder, содержащий объект GrammarBuilder, за которым следует объект Choices.

public:
 static System::Speech::Recognition::GrammarBuilder ^ Add(System::Speech::Recognition::GrammarBuilder ^ builder, System::Speech::Recognition::Choices ^ choices);
public static System.Speech.Recognition.GrammarBuilder Add (System.Speech.Recognition.GrammarBuilder builder, System.Speech.Recognition.Choices choices);
static member Add : System.Speech.Recognition.GrammarBuilder * System.Speech.Recognition.Choices -> System.Speech.Recognition.GrammarBuilder
Public Shared Function Add (builder As GrammarBuilder, choices As Choices) As GrammarBuilder

Параметры

builder
GrammarBuilder

Первый элемент грамматики.

choices
Choices

Второй элемент грамматики, который представляет набор вариантов.

Возвращаемое значение

Объект GrammarBuilder для последовательности элементов builder, за которой следует элемент choices.

Примеры

В следующем примере создается грамматика распознавания речи, которая может распознавать две фразы: "Сделать цвет фона" и "Задать цвет фона ", где цвет выбирается из набора цветов. Для построения окончательной грамматики используются различные типы, например String, Choicesи GrammarBuilder объекты . Явные операторы приведения в вызовах Add методов являются необязательными.

private Grammar CreateColorGrammar()
{

  // Create a set of color choices.
  Choices colorChoice = new Choices(new string[] {"red", "green", "blue"});

  // Create grammar builders for the two versions of the phrase.
  GrammarBuilder makePhrase =
    GrammarBuilder.Add((GrammarBuilder)"Make background", colorChoice);
  GrammarBuilder setPhrase =
    GrammarBuilder.Add("Set background to", (GrammarBuilder)colorChoice);

  // Create a Choices for the two alternative phrases, convert the Choices
  // to a GrammarBuilder, and construct the grammar from the result.
  Choices bothChoices = new Choices(new GrammarBuilder[] {makePhrase, setPhrase});
  GrammarBuilder bothPhrases = new GrammarBuilder(bothChoices);

  Grammar grammar = new Grammar(bothPhrases);
  grammar.Name = "backgroundColor";
  return grammar;
}

Комментарии

GrammarBuilder поддерживает неявные преобразования из следующих классов:

Этот метод принимает указанные выше объекты для builder параметра .

Дополнительные сведения см. в операторах Implicit и Addition .

Важно!

При объединении Choices объектов и GrammarBuilder , содержащих SemanticResultValue или SemanticResultKey экземпляры с другими элементами грамматики, избегайте создания повторяющихся семантических элементов с тем же именем ключа или нескольких семантических элементов, которые могут многократно изменять Value свойство SemanticValue объекта. Распознаватель речи может вызвать исключение, если он сталкивается с этими обстоятельствами.

См. также раздел

Применяется к

Add(GrammarBuilder, GrammarBuilder)

Исходный код:
GrammarBuilder.cs
Исходный код:
GrammarBuilder.cs
Исходный код:
GrammarBuilder.cs

Создает новый объект GrammarBuilder, содержащий последовательность из двух объектов GrammarBuilder.

public:
 static System::Speech::Recognition::GrammarBuilder ^ Add(System::Speech::Recognition::GrammarBuilder ^ builder1, System::Speech::Recognition::GrammarBuilder ^ builder2);
public static System.Speech.Recognition.GrammarBuilder Add (System.Speech.Recognition.GrammarBuilder builder1, System.Speech.Recognition.GrammarBuilder builder2);
static member Add : System.Speech.Recognition.GrammarBuilder * System.Speech.Recognition.GrammarBuilder -> System.Speech.Recognition.GrammarBuilder
Public Shared Function Add (builder1 As GrammarBuilder, builder2 As GrammarBuilder) As GrammarBuilder

Параметры

builder1
GrammarBuilder

Первый элемент грамматики.

builder2
GrammarBuilder

Второй элемент grammar.

Возвращаемое значение

Объект GrammarBuilder для последовательности элементов builder1, за которой следует элемент builder2.

Примеры

В следующем примере создается грамматика распознавания речи, которая может распознавать две фразы: "Сделать цвет фона" и "Задать цвет фона ", где цвет выбирается из набора цветов. Для построения окончательной грамматики используются различные типы, например String, Choicesи GrammarBuilder объекты . Явные операторы приведения в вызовах Add методов являются необязательными.

private Grammar CreateColorGrammar()
{

  // Create a set of color choices.
  Choices colorChoice = new Choices(new string[] {"red", "green", "blue"});

  // Create grammar builders for the two versions of the phrase.
  GrammarBuilder makePhrase =
    GrammarBuilder.Add((GrammarBuilder)"Make background", colorChoice);
  GrammarBuilder setPhrase =
    GrammarBuilder.Add("Set background to", (GrammarBuilder)colorChoice);

  // Create a Choices for the two alternative phrases, convert the Choices
  // to a GrammarBuilder, and construct the grammar from the result.
  Choices bothChoices = new Choices(new GrammarBuilder[] {makePhrase, setPhrase});
  GrammarBuilder bothPhrases = new GrammarBuilder(bothChoices);

  Grammar grammar = new Grammar(bothPhrases);
  grammar.Name = "backgroundColor";
  return grammar;
}

Комментарии

GrammarBuilder поддерживает неявные преобразования из следующих классов:

Этот метод принимает указанные выше объекты для builder1 параметра или builder2 .

Дополнительные сведения см. в операторах Implicit и Addition .

Важно!

При объединении Choices объектов и GrammarBuilder , содержащих SemanticResultValue или SemanticResultKey экземпляры с другими элементами грамматики, избегайте создания повторяющихся семантических элементов с тем же именем ключа или нескольких семантических элементов, которые могут многократно изменять Value свойство SemanticValue объекта. Распознаватель речи может вызвать исключение, если он сталкивается с этими обстоятельствами.

См. также раздел

Применяется к

Add(GrammarBuilder, String)

Исходный код:
GrammarBuilder.cs
Исходный код:
GrammarBuilder.cs
Исходный код:
GrammarBuilder.cs

Создает новый объект GrammarBuilder, содержащий объект GrammarBuilder, после которого следует фраза.

public:
 static System::Speech::Recognition::GrammarBuilder ^ Add(System::Speech::Recognition::GrammarBuilder ^ builder, System::String ^ phrase);
public static System.Speech.Recognition.GrammarBuilder Add (System.Speech.Recognition.GrammarBuilder builder, string phrase);
static member Add : System.Speech.Recognition.GrammarBuilder * string -> System.Speech.Recognition.GrammarBuilder
Public Shared Function Add (builder As GrammarBuilder, phrase As String) As GrammarBuilder

Параметры

builder
GrammarBuilder

Первый элемент грамматики.

phrase
String

Второй элемент грамматики, который представляет последовательность слов.

Возвращаемое значение

Объект GrammarBuilder для последовательности элементов builder, за которой следует элемент phrase.

Примеры

В следующем примере создается грамматика распознавания речи, которая может распознавать две фразы: "Сделать цвет фона" и "Задать цвет фона ", где цвет выбирается из набора цветов. Для построения окончательной грамматики используются различные типы, например String, Choicesи GrammarBuilder объекты . Явные операторы приведения в вызовах Add методов являются необязательными.

private Grammar CreateColorGrammar()
{

  // Create a set of color choices.
  Choices colorChoice = new Choices(new string[] {"red", "green", "blue"});

  // Create grammar builders for the two versions of the phrase.
  GrammarBuilder makePhrase =
    GrammarBuilder.Add((GrammarBuilder)"Make background", colorChoice);
  GrammarBuilder setPhrase =
    GrammarBuilder.Add("Set background to", (GrammarBuilder)colorChoice);

  // Create a Choices for the two alternative phrases, convert the Choices
  // to a GrammarBuilder, and construct the grammar from the result.
  Choices bothChoices = new Choices(new GrammarBuilder[] {makePhrase, setPhrase});
  GrammarBuilder bothPhrases = new GrammarBuilder(bothChoices);

  Grammar grammar = new Grammar(bothPhrases);
  grammar.Name = "backgroundColor";
  return grammar;
}

Комментарии

GrammarBuilder поддерживает неявные преобразования из следующих классов:

Этот метод принимает указанные выше объекты для builder параметра .

Дополнительные сведения см. в операторах Implicit и Addition .

См. также раздел

Применяется к

Add(String, GrammarBuilder)

Исходный код:
GrammarBuilder.cs
Исходный код:
GrammarBuilder.cs
Исходный код:
GrammarBuilder.cs

Создает новый объект GrammarBuilder, содержащий фразу, после которой следует объект GrammarBuilder.

public:
 static System::Speech::Recognition::GrammarBuilder ^ Add(System::String ^ phrase, System::Speech::Recognition::GrammarBuilder ^ builder);
public static System.Speech.Recognition.GrammarBuilder Add (string phrase, System.Speech.Recognition.GrammarBuilder builder);
static member Add : string * System.Speech.Recognition.GrammarBuilder -> System.Speech.Recognition.GrammarBuilder
Public Shared Function Add (phrase As String, builder As GrammarBuilder) As GrammarBuilder

Параметры

phrase
String

Первый элемент грамматики, который представляет последовательность слов.

builder
GrammarBuilder

Второй элемент grammar.

Возвращаемое значение

Объект GrammarBuilder для последовательности элементов phrase, за которой следует элемент builder.

Примеры

В следующем примере создается грамматика распознавания речи, которая может распознавать две фразы: "Сделать цвет фона" и "Задать цвет фона ", где цвет выбирается из набора цветов. Для построения окончательной грамматики используются различные типы, например String, Choicesи GrammarBuilder объекты . Явные операторы приведения в вызовах Add методов являются необязательными.

private Grammar CreateColorGrammar()
{

  // Create a set of color choices.
  Choices colorChoice = new Choices(new string[] {"red", "green", "blue"});

  // Create grammar builders for the two versions of the phrase.
  GrammarBuilder makePhrase =
    GrammarBuilder.Add((GrammarBuilder)"Make background", colorChoice);
  GrammarBuilder setPhrase =
    GrammarBuilder.Add("Set background to", (GrammarBuilder)colorChoice);

  // Create a Choices for the two alternative phrases, convert the Choices
  // to a GrammarBuilder, and construct the grammar from the result.
  Choices bothChoices = new Choices(new GrammarBuilder[] {makePhrase, setPhrase});
  GrammarBuilder bothPhrases = new GrammarBuilder(bothChoices);

  Grammar grammar = new Grammar(bothPhrases);
  grammar.Name = "backgroundColor";
  return grammar;
}

Комментарии

GrammarBuilder поддерживает неявные преобразования из следующих классов:

Этот метод принимает указанные выше объекты для builder параметра .

Дополнительные сведения см. в операторах Implicit и Addition .

См. также раздел

Применяется к