FileSubmitConnection.Filename, propriété

Article
04/27/2010

Obtient une XPathTypedValue qui évalue le nom de fichier qui sera attribué au formulaire actif lors de son envoi par l'objet FileSubmitConnection.

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

Syntaxe

Public MustOverride ReadOnly Property Filename As XPathTypedValue

Dim instance As FileSubmitConnection
Dim value As XPathTypedValue

value = instance.Filename

public abstract XPathTypedValue Filename { get; }

Valeur de la propriété

XPathTypedValue qui évalue le nom de fichier qui sera attribué au formulaire actif lors de son envoi.

Remarques

La valeur de la propriété Filename de la classe FileSubmitConnection est renvoyée en tant qu'objet XPathTypedValue, qui peut être défini en spécifiant une chaîne littérale à l'aide de la méthode SetStringValue de la classe XPathTypedValue, ou en spécifiant une expression XPath à l'aide de la propriété XPath de la classe XPathTypedValue. Pour plus d'informations et des exemples de code, voir l'aide relative à la classe XPathTypedValue.

En l'absence d'extension de nom de fichier, l'extension « .xml » est ajoutée à la chaîne. Si la propriété Filename prend la valeur null, le formulaire est nommé « Form.xml » lors de son envoi.

Si une expression XPath, comme concat("Status Report -", field1), a été spécifiée dans la zone Nom de fichier de l'Assistant de connexion de données au moment de la définition de la connexion, vous pouvez renvoyer cette expression à l'aide de la propriété XPath de la classe XPathTypedValue, comme montré dans l'exemple suivant.

   FileSubmitConnection submitConnection = 
      (FileSubmitConnection)(DataConnections["SharePoint Library"]);
   MessageBox.Show (submitConnection.Filename.XPath.ToString());

   Dim submitConnection As FileSubmitConnection = 
      DirectCast(DataConnections["SharePoint Library"], _
      FileSubmitConnection)
   MessageBox.Show (submitConnection.Filename.XPath.ToString())

Ce membre est accessible uniquement par les formulaires qui s'exécutent dans le même domaine que le formulaire ouvert ou par les formulaires qui disposent d'autorisations indépendantes des domaines.

Ce type ou ce membre est accessible à partir du code exécuté dans les formulaires ouverts dans Microsoft Office InfoPath 2007 ou un navigateur Web.

Exemple

L'exemple suivant utilise la propriété Filename de l'objet FileSubmitConnection pour afficher le nom de fichier qui sera utilisé lors de l'envoi du formulaire vers la connexion de données.

   FileSubmitConnection submitConnection = 
      (FileSubmitConnection)(DataConnections["SharePoint Library"]);
   MessageBox.Show (submitConnection.Filename.ToString());

   Dim submitConnection As FileSubmitConnection = 
      DirectCast(DataConnections["SharePoint Library"], _
      FileSubmitConnection)
   MessageBox.Show (submitConnection.Filename.ToString())

Voir aussi

Référence

FileSubmitConnection, classe
Membres FileSubmitConnection
Microsoft.Office.InfoPath, espace de noms

Partager via