PublishingPageCollection.Add - Méthode (String, SPFile, Guid, String, PageConversionPriority)

Article
03/15/2016

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.String

Nom de la nouvelle PublishingPage.

fileToConvert
Type : Microsoft.SharePoint.SPFile

Fichier à convertir pour obtenir le contenu de la page.

transformerId
Type : System.Guid

ID de transformateur de document à utiliser pour la conversion.

configXml
Type : System.String

Paramètres à utiliser pour la conversion.

priority
Type : Microsoft.SharePoint.Publishing.PageConversionPriority

Niveau 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.

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.