Concepteur de formulaires : zone de texte SQL modifiable - propriétés

Utilisez le contrôle Zone de texte SQL modifiable (SqlTextBox) pour afficher le résultat d'une requête SQL, par exemple la surface qui est stockée dans une autre table. Il est recommandé d'utiliser ce type de contrôle uniquement lorsque vous interrogez un attribut unique.

Si vous ne souhaitez pas modifier la valeur, mais simplement l'afficher, il est recommandé d'utiliser le contrôle Zone de texte SQL en lecture seule, qui offre de meilleures performances.

Propriété

Description

Catégorie système

 

Nom de la classe

Zone de texte SQL

Nom

Spécifie le nom du matériau. Par exemple, $SQLTEXTBOX1.

Base

 

Verrouillé

Si la propriété est définie sur True, la valeur ne peut pas être modifiée.

Catégorie spécifique

 

Alignement à droite

Si la propriété est définie sur True, la valeur est alignée. Indique si la valeur est alignée sur la droite de la zone d'entrée.

Autorisation de mise à jour multiple

Si la valeur est False, cela permet de vérifier si le processus de mise à jour ne tente pas de mettre à jour plusieurs lignes de la table associée. Si tel est le cas, la mise à jour est entièrement ignorée et un message s'affiche. En effet, une instruction SQL erronée peut détruire vos données en générant des mises à jour non souhaitées.

Nom de l'attribut détaillé

Permet de définir l'attribut (à sélectionner dans la table détaillée) que vous souhaitez afficher.

Filtre détaillé

Expression de filtre pour l'instruction de sélection (sans expression WHERE). Cliquez sur pour ouvrir l'assistant SQL. Utilisez l'assistant SQL pour créer l'instruction de filtre. Vous devez cependant supprimer la première partie, y compris la clause WHERE.

Table détaillée

Table à partir de laquelle vous pouvez sélectionner des données.

Notez la différence entre Zone de texte SQL en lecture seule et Zone de texte SQL modifiable. Ces deux contrôles vous permettent d'interroger les données, mais le contrôle Zone de texte SQL en lecture seule génère une étiquette en lecture seule qui ne peut pas être modifiée. Le contrôle Zone de texte SQL modifiable génère une zone de texte dans laquelle la valeur peut être modifiée et enregistrée (mise à jour) dans la base de données.

C'est la raison pour laquelle les instructions SQL sont définies de façon différente. Bien que l'instruction d'étiquette SQL en lecture seule puisse être définie sous la forme d'une expression unique dans la propriété SQL, l'instruction Zone de texte SQL modifiable compte trois composants (propriétés Nom de l'attribut détaillé, Filtre détaillé et Table détaillée). Les deux instructions conduisent toutefois au même résultat.

En raison de la séparation, le système peut procéder à la mise à jour de l'enregistrement. Lorsque l'utilisateur sauvegarde l'enregistrement, le système met à jour la table détaillée associée, à l'aide de l'option suivante :

Update <detailtable name> set <detailfield name> ='<your input>' where <detail filter>.