PublishingPageCollection.Add - Méthode (String, SPFile, Guid, PageConversionPriority)
Remarque : cette API est désormais obsolète.
Crée un nouveau PublishingPage dans les PublishingPageCollection de l' PublishingWeb par la conversion de document source.
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, _
priority As PageConversionPriority _
) As PublishingPage
'Utilisation
Dim instance As PublishingPageCollection
Dim newPageName As String
Dim fileToConvert As SPFile
Dim transformerId As Guid
Dim priority As PageConversionPriority
Dim returnValue As PublishingPage
returnValue = instance.Add(newPageName, _
fileToConvert, transformerId, priority)
[ObsoleteAttribute("This member is obsolete - use the specialized Office services instead",
false)]
public PublishingPage Add(
string newPageName,
SPFile fileToConvert,
Guid transformerId,
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.
priority
Type : Microsoft.SharePoint.Publishing.PageConversionPriorityénumération PageConversionPriority pour la conversion.
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 de lever. Par exemple, cette exception s'affiche lorsque les images incorporées d'être supprimés. Cette exception doit toujours être interceptée par l'appelant. Si le membre PublishingPage de l'exception levée n'est pas null, le problème qui a provoqué l'exception est un avertissement de convertisseur, et la page peut être utilisée avec l'inconvénient qu'il puisse avoir 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.
La valeur de retour et les exceptions sont identiques à celles de la fonction Add(stringname, PageLayoutlayout) qui prend le nouveau nom et la mise en page directement, avec l'ajout de l' DocumentToPublishingPageConversionException parfois levée.
Voir aussi
Référence
PublishingPageCollection classe