PublishingPageCollection.Add - Méthode (String, SPFile, Guid, String, PageConversionPriority)
Remarque : cette API est désormais obsolète.
Crée un nouveau PublishingPage dans les PublishingPageCollection de la PublishingWeb b par la conversion de document source en fonction des paramètres qui sont passés.
Espace de noms : Microsoft.SharePoint.Publishing
Assembly : Microsoft.SharePoint.Publishing (dans Microsoft.SharePoint.Publishing.dll)
Syntaxe
'Déclaration
<ObsoleteAttribute("This member is obsolete - use the specialized Office services instead", _
False)> _
Public Function Add ( _
newPageName As String, _
fileToConvert As SPFile, _
transformerId As Guid, _
configXml As String, _
priority As PageConversionPriority _
) As PublishingPage
'Utilisation
Dim instance As PublishingPageCollection
Dim newPageName As String
Dim fileToConvert As SPFile
Dim transformerId As Guid
Dim configXml As String
Dim priority As PageConversionPriority
Dim returnValue As PublishingPage
returnValue = instance.Add(newPageName, _
fileToConvert, transformerId, configXml, _
priority)
[ObsoleteAttribute("This member is obsolete - use the specialized Office services instead",
false)]
public PublishingPage Add(
string newPageName,
SPFile fileToConvert,
Guid transformerId,
string configXml,
PageConversionPriority priority
)
Paramètres
newPageName
Type : System.StringNom de la nouvelle PublishingPage.
fileToConvert
Type : Microsoft.SharePoint.SPFileFichier à convertir pour obtenir le contenu de la page.
transformerId
Type : System.GuidID de transformateur de document à utiliser pour la conversion.
configXml
Type : System.StringParamètres à utiliser pour la conversion.
priority
Type : Microsoft.SharePoint.Publishing.PageConversionPriorityNiveau de priorité pour la conversion. la valeur 0 indique que la conversion s'exécute immédiatement.
Valeur renvoyée
Type : Microsoft.SharePoint.Publishing.PublishingPage
Le nouvellement créé PublishingPage.
Exceptions
Exception | Condition |
---|---|
DocumentToPublishingPageConversionException | Si la conversion échoue ou rencontre des problèmes qui provoquent le convertisseur émettre un avertissement, par exemple lorsque des images incorporées obtenir glissées, cette exception est levée. Cette exception doit toujours être interceptée par l'appelant. Si le membre PublishingPage de cette exception n'est pas null, le problème qui a provoqué l'exception est un avertissement de convertisseur. La page peut être utilisée avec l'inconvénient qu'il présente des problèmes de fidélité éventuellement importante, en fonction de l'avertissement de convertisseur. |
Remarques
Utilise la fonctionnalité de création de client intelligent pour ajouter une page à la conversion d'un document spécifié au format HTML. La fonctionnalité de création de client intelligent spécifie les paramètres à utiliser, tels que le mise en page à utiliser pour la nouvelle page et du champ dans lequel stocker le code HTML converti dans.
Cette méthode est identique à Add(stringnewpageName, SPFilefileToConvert, GuidtranformerId, PageConversionPrioritypriority) , sauf que cette version accepte les paramètres à partir du paramètre configXml et non à partir de la configuration du type de contenu.
Cette méthode peut lever toutes les exceptions Add(stringname, PageLayoutlayout) lève plus DocumentToPublishingPageConversionException.
Voir aussi
Référence
PublishingPageCollection classe
PublishingPageCollection - Membres