XmlForm.SaveAs - Méthode
Enregistre le formulaire dans l’URL (Uniform Resource Locator) spécifiée.
Espace de noms : Microsoft.Office.InfoPath
Assembly : Microsoft.Office.InfoPath (dans Microsoft.Office.InfoPath.dll)
Syntaxe
'Déclaration
Public MustOverride Sub SaveAs ( _
fileUrl As String _
)
'Utilisation
Dim instance As XmlForm
Dim fileUrl As String
instance.SaveAs(fileUrl)
public abstract void SaveAs(
string fileUrl
)
Paramètres
fileUrl
Type : System.StringChemin d’accès ou URL dans lequel le formulaire doit être enregistré.
Exceptions
| Exception | Condition |
|---|---|
| ArgumentNullException | La valeur passée pour fileUrl est une référence Null (Rien dans Visual Basic). |
| ArgumentException | La valeur passée pour le paramètre fileUrl est "" ou n’est pas valide. |
| InvalidOperationException | La méthode Save a été appelée à partir de l’événement Loading. |
| SecurityException | Le modèle de formulaire n’est pas configuré avec l’option Autorisation totale de la catégorie Sécurité et approbation dans la boîte de dialogue Options de formulaire. |
Remarques
La valeur passée comme paramètre fileUrl doit représenter un chemin d’accès ou une URL valide et doit inclure le nom du fichier avec l’extension .xml.
L’appel de la méthode SaveAs affecte à la propriété Dirty du formulaire la valeur false dès que ce dernier est enregistré.
Seuls les formulaires ouverts à partir d’un modèle de formulaire qui ont été configurés pour s’exécuter en mode confiance totale en utilisant la catégorie Sécurité et approbation de la boîte de dialogue Options de formulaire peuvent accéder à ce membre. Ce membre nécessite la confiance totale pour l’appelant immédiat et ne peut être utilisé par un code ayant un niveau de confiance partiel. Pour plus d’informations, voir « Utilisation de bibliothèques à partir de code d’un niveau de confiance partiel » sur MSDN.
Vous pouvez uniquement accéder à ce type ou à ce membre à partir du code exécuté dans les formulaires ouverts dans Microsoft InfoPath Filler.
Exemples
Dans l’exemple de code suivant, la propriété New permet de déterminer si le formulaire a été précédemment enregistré et, si ce n’est pas le cas, la méthode SaveAs est utilisée pour enregistrer le formulaire vers l’URL spécifiée.
if(this.New)
{
this.SaveAs("c:\\myforms\\form1.xml");
}
else
{
this.Save();
}
If(Me.New) Then
Me.SaveAs("c:\\myforms\\form1.xml")
Else
Me.Save()
End If
Autorisations
-
Permet d’écrire le formulaire dans le système de fichiers à l’aide de la valeur passée pour le paramètre fileUrl. Énumérations associées :System.Security.Permissions.FileIOPermissionAccess.Append, System.Security.Permissions.FileIOPermissionAccess.Read, System.Security.Permissions.FileIOPermissionAccess.Write