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

Article
03/15/2016

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

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.

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

PublishingPageCollection - Membres

Add - Surcharge

Microsoft.SharePoint.Publishing - Espace de noms

Partager via