Partager via


IFormBuilder<T> Interface

Définition

Interface pour la création d’un formulaire.

public interface IFormBuilder<T> where T : class
type IFormBuilder<'T (requires 'T : null)> = interface
Public Interface IFormBuilder(Of T)

Paramètres de type

T

État du formulaire.

Dérivé

Remarques

Un formulaire se compose d’une série d’étapes qui peuvent être l’une des suivantes :

Par défaut, les étapes sont exécutées dans l’ordre des Message(String, ActiveDelegate<T>, IEnumerable<String>)appels et Field(IField<T>)Confirm(String, ActiveDelegate<T>, IEnumerable<String>) . Si vous n’effectuez pas de contrôle explicite, les étapes sont exécutées dans l’ordre défini dans l’état du formulaire avec une confirmation finale. Cette interface vous permet de créer un formulaire en composant ensemble des champs, des messages et des confirmations. Les blocs de construction Fluent fournissent des modèles courants, comme les champs basés sur votre classe d’état, mais vous pouvez également créer votre propre définition d’un formulaire à l’aide d’Advanced.IField. Si vous souhaitez créer un formulaire à l’aide de la réflexion C# sur votre classe d’état, utilisez FormBuilder. Pour générer un formulaire de manière déclarative via un schéma JSON, vous pouvez utiliser Json.FormBuilderJson.

Les formulaires sont sensibles à la culture actuelle de l’interface utilisateur du thread. Les chaînes Microsoft.Bot.Builder sont localisées dans cette culture si elles sont disponibles. Vous pouvez également localiser les chaînes générées pour votre formulaire en appelant IForm.SaveResources ou en utilisant l’outil RView et en ajoutant cette ressource à votre projet. Pour les chaînes dans des champs dynamiques, des messages ou des confirmations, vous devez utiliser les mécanismes C# normaux pour les localiser. Pour plus d’informations, consultez la documentation de vue d’ensemble.

Propriétés

Configuration

La configuration du formulaire fournit des modèles et des paramètres par défaut.

Méthodes

AddRemainingFields(IEnumerable<String>)

Ajoutez tous les champs qui ne sont pas déjà ajoutés au formulaire.

Build(Assembly, String)

Générez le formulaire en fonction des méthodes appelées sur le générateur.

Confirm(MessageDelegate<T>, ActiveDelegate<T>, IEnumerable<String>)

Générez une confirmation à l’aide d’un délégué pour générer dynamiquement le message.

Confirm(PromptAttribute, ActiveDelegate<T>, IEnumerable<String>)

Ajoutez une étape de confirmation.

Confirm(String, ActiveDelegate<T>, IEnumerable<String>)

Ajoutez une étape de confirmation.

Field(IField<T>)

Dérfinez une étape de champ en fournissant votre propre définition de champ.

Field(String, ActiveDelegate<T>, ValidateAsyncDelegate<T>)

Définissez une étape pour remplir une valeur particulière dans l’état du formulaire.

Field(String, PromptAttribute, ActiveDelegate<T>, ValidateAsyncDelegate<T>)

Définissez une étape pour remplir une valeur particulière dans l’état du formulaire.

Field(String, String, ActiveDelegate<T>, ValidateAsyncDelegate<T>)

Définissez une étape pour remplir une valeur particulière dans l’état du formulaire.

HasField(String)

Testez pour voir s’il existe déjà un champ avec name.

Message(MessageDelegate<T>, ActiveDelegate<T>, IEnumerable<String>)

Générez un message à l’aide d’un délégué pour générer dynamiquement le message.

Message(PromptAttribute, ActiveDelegate<T>, IEnumerable<String>)

Afficher un message avec plus de contrôle de format qui ne nécessite pas de réponse.

Message(String, ActiveDelegate<T>, IEnumerable<String>)

Afficher un message qui ne nécessite pas de réponse.

OnCompletion(OnCompletionAsyncDelegate<T>)

Déléguer à l’appel lorsque le formulaire est rempli.

Prompter(PromptAsyncDelegate<T>)

Déléguer pour envoyer une invite à l’utilisateur.

S’applique à