GrammarBuilder.Add Метод

Определение

Пространство имен:
System.Speech.Recognition
Сборка:
System.Speech.dll
Пакет:
System.Speech v11.0.0-preview.4.26230.115

Создает новый 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объектов , SemanticResultKeySemanticResultValueи строковых объектов. Дополнительные сведения см. в Implicit разделе и Addition операторах.

Important

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

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

Add(Choices, GrammarBuilder)

Исходный код:
GrammarBuilder.cs
Исходный код:
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

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

builder
GrammarBuilder

Второй элемент грамматики.

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

GrammarBuilder

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

Комментарии

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

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

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

Important

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

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

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

Add(GrammarBuilder, Choices)

Исходный код:
GrammarBuilder.cs
Исходный код:
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

A 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 операторах.

Important

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

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

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

Add(GrammarBuilder, GrammarBuilder)

Исходный код:
GrammarBuilder.cs
Исходный код:
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

Второй элемент грамматики.

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

GrammarBuilder

A 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 операторах.

Important

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

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

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

Add(GrammarBuilder, String)

Исходный код:
GrammarBuilder.cs
Исходный код:
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

A 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.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

Второй элемент грамматики.

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

GrammarBuilder

A 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 операторах.

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

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