Langue

IFormBuilder<T> Interface

Définition

Interface pour créer 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

Forme d’état.

Dérivé

Remarques

Un formulaire se compose d’une série d’étapes pouvant ê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 Confirm(String, ActiveDelegate<T>, IEnumerable<String>)Field(IField<T>) . Si vous ne prenez pas le contrôle explicite, les étapes seront exécutées dans l’ordre défini dans l’état de forme avec une confirmation finale. Cette interface vous permet de construire rapidement un formulaire en composant ensemble champs, messages et confirmations. Les blocs de construction Fluent fournissent des schémas courants comme les champs basés sur votre classe d’État, mais vous pouvez aussi construire votre propre définition d’un formulaire en utilisant Advanced.IField. Si vous voulez construire un formulaire en utilisant la réflexion C# sur votre classe d’état, utilisez FormBuilder. Pour construire un formulaire de manière déclarative via JSON Schema, vous pouvez utiliser Json.FormBuilderJson.

Les formulaires sont sensibles à la culture actuelle de l’interface utilisateur du thread. Le Microsoft. Les chaînes de Bot.Builder se localisent 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 les champs dynamiques, les messages ou les confirmations, il faudra utiliser les mécanismes C# habituels pour les localiser. Consultez la documentation d’aperçu pour plus d’informations.

Propriétés

Nom Description
Configuration

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

Méthodes

Nom Description
AddRemainingFields(IEnumerable<String>)

Ajoutez tous les champs qui n’ont pas encore été ajoutés au formulaire.

Build(Assembly, String)

Construis le formulaire selon les méthodes demandées par le constructeur.

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

Générez une confirmation en utilisant un délégué pour construire 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>)

Affinez 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)

Tester s’il existe déjà un champ avec name.

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

Générez un message en utilisant un délégué pour construire dynamiquement le message.

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

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

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

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

OnCompletion(OnCompletionAsyncDelegate<T>)

Déléguez pour appeler lorsque le formulaire sera rempli.

Prompter(PromptAsyncDelegate<T>)

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

S’applique à