Partager via


XPathTypedValue - Classe

Implémente l'objet renvoyé par certaines valeurs des propriétés des classes EmailSubmitConnection et FileSubmitConnection pour obtenir et définir ces valeurs.

Hiérarchie d’héritage

System.Object
  Microsoft.Office.InfoPath.XPathTypedValue

Espace de noms :  Microsoft.Office.InfoPath
Assembly :  Microsoft.Office.InfoPath (dans Microsoft.Office.InfoPath.dll)

Syntaxe

'Déclaration
Public MustInherit Class XPathTypedValue
'Utilisation
Dim instance As XPathTypedValue
public abstract class XPathTypedValue

Remarques

Un objet XPathTypedValue est renvoyé par les membres suivants de la classe EmailSubmitConnection pour obtenir ou définir leurs valeurs :

Un objet XPathTypedValue est renvoyé par la propriété Filename de la classe EmailSubmitConnection pour obtenir ou définir sa valeur.

Pour lire ou définir ces propriétés, vous devez utiliser les propriétés et les méthodes de la classe XPathTypedValue.

Vous pouvez définir la valeur d'une propriété qui renvoie un objet XPathTypedValue en spécifiant soit une chaîne littérale, soit une expression XPath. Une expression XPath vous permet de définir la propriété en extrayant la valeur d'un champ du formulaire (ou d'un autre nœud des sources de données du formulaire). En outre, vous pouvez utiliser les opérateurs et les fonctions XPath pour effectuer d'autres opérations sur les données extraites.

Pour définir la valeur d'une propriété sous forme de chaîne littérale, utilisez la méthode SetStringValue de la classe XPathTypedValue.

L'exemple suivant montre comment définir la valeur de la propriété To de la classe EmailSubmitConnection en spécifiant une adresse de messagerie comme chaîne littérale à l'aide de la méthode SetStringValue.

// Get the e-mail submit data connection configured for the form.
EmailSubmitConnection mySubmit = (EmailSubmitConnection)
   (this.DataConnections["Email Submit"]);

// Set To property to literal string value.
mySubmit.To.SetStringValue("someone@example.com");

// Submit form.
mySubmit.Execute();
' Get the e-mail submit data connection configured for the form.
Dim mySubmit As EmailSubmitConnection = DirectCast(_
   Me.DataConnections["Email Submit"], EmailSubmitConnection)

' Set To property to literal string value.
mySubmit.To.SetStringValue("someone@example.com")

' Submit form.
mySubmit.Execute()

Pour définir la valeur d'une propriété sous forme d'expression XPath, utilisez la méthode XPath de la classe XPathTypedValue.

L'exemple suivant montre comment définir la valeur de la propriété To de la classe EmailSubmitConnection, en spécifiant une adresse de messagerie comme expression XPath, qui extrait la valeur du champ ToAddress sur le formulaire utilisant la propriété XPath.

// Get the e-mail submit data connection configured for the form.
EmailSubmitConnection mySubmit = (EmailSubmitConnection)
   (this.DataConnections["Email Submit"]);

// Set To property to XPath for ToAddress field.
mySubmit.To.XPath = "/my:myFields/my:ToAddress";

// Submit form.
mySubmit.Execute();
' Get the e-mail submit data connection configured for the form.
Dim mySubmit As EmailSubmitConnection = DirectCast(_
   Me.DataConnections["Email Submit"], EmailSubmitConnection)

' Set To property to XPath for ToAddress field.
mySubmit.To = "/my:myFields/my:ToAddress"

' Submit form.
mySubmit.Execute()

Pour lire les valeurs des propriétés renvoyées en tant qu'objets XPathTypedValue, utilisez la méthode Evaluate de la classe XPathTypedValue pour évaluer une expression XPath et renvoyer les résultats sous forme de chaîne, ou utilisez la méthode ToString de la classe XPathTypedValue pour renvoyer une chaîne littérale.

Cohérence de thread

Tous les membres statique (Partagé dans Visual Basic)s publics de ce type sont thread-safe. Cela n’est pas garanti pour les membres d’instance.

Voir aussi

Référence

XPathTypedValue - Membres

Microsoft.Office.InfoPath - Espace de noms