FileSubmitConnection.Filename - Propriété
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
'Déclaration
Public MustOverride ReadOnly Property Filename As XPathTypedValue
Get
'Utilisation
Dim instance As FileSubmitConnection
Dim value As XPathTypedValue
value = instance.Filename
public abstract XPathTypedValue Filename { get; }
Valeur de propriété
Type : Microsoft.Office.InfoPath.XPathTypedValue
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 une référence Null (Rien dans Visual Basic), 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())
Seuls les formulaires qui s’exécutent dans le même domaine que le formulaire actuellement ouvert ou les formulaires disposant d’autorisations inter-domaines peuvent accéder à ce membre.
Vous pouvez accéder à ce type ou à ce membre à partir du code exécuté dans les formulaires ouverts dans Microsoft InfoPath Filler ou dans un navigateur web.
Exemples
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())