(String, SPFile, Guid, String, PageConversionPriority) del método PublishingPageCollection.Add

Artículo
03/15/2016

NOTA: esta API está ahora obsoleta.

Crea un nuevo PublishingPage en la PublishingPageCollection del PublishingWeb b mediante la conversión de un documento de origen de acuerdo con la configuración que se pasan.

Espacio de nombres: Microsoft.SharePoint.Publishing
Ensamblado: Microsoft.SharePoint.Publishing (en Microsoft.SharePoint.Publishing.dll)

Sintaxis

'Declaración
<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
'Uso
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
)

Parámetros

newPageName
Tipo: System.String

Nombre de la nueva PublishingPage.

fileToConvert
Tipo: Microsoft.SharePoint.SPFile

Archivos para convertir para obtener el contenido de la página.

transformerId
Tipo: System.Guid

Identificador de documento transformador que se va a usar para la conversión.

configXml
Tipo: System.String

Configuración que se debe usar para la conversión.

priority
Tipo: Microsoft.SharePoint.Publishing.PageConversionPriority

Nivel de prioridad para la conversión. 0 indica que la conversión se produce de forma inmediata.

Valor devuelto

Tipo: Microsoft.SharePoint.Publishing.PublishingPage
El recién creado PublishingPage.

Excepciones

Excepción	Condición
DocumentToPublishingPageConversionException	Si la conversión se produce un error o encuentra problemas que hacer que el convertidor emitir una advertencia, como cuando obtener desciende imágenes incrustadas, produce esta excepción. Esta excepción se debe usar siempre el autor de la llamada. Si el miembro PublishingPage de esta excepción no es nulo, el problema que provocó la excepción es una advertencia de convertidor. La página se puede usar con la salvedad de que tenga problemas de fidelidad potencialmente significativo, según la advertencia de convertidor.

DocumentToPublishingPageConversionException

Si la conversión se produce un error o encuentra problemas que hacer que el convertidor emitir una advertencia, como cuando obtener desciende imágenes incrustadas, produce esta excepción. Esta excepción se debe usar siempre el autor de la llamada.

Si el miembro PublishingPage de esta excepción no es nulo, el problema que provocó la excepción es una advertencia de convertidor. La página se puede usar con la salvedad de que tenga problemas de fidelidad potencialmente significativo, según la advertencia de convertidor.

Comentarios

Usa el característica de creación de cliente inteligente para agregar una página mediante la conversión de un documento especificado a HTML. El característica de creación de cliente inteligente especifica la configuración que se va a utilizar, como qué diseño de página que desee usar para la nueva página y el campo para almacenar del HTML convertido en.

Este método es idéntico a Add(stringnewpageName, SPFilefileToConvert, GuidtranformerId, PageConversionPrioritypriority) , excepto que esta versión toma la configuración del parámetro configXml y no de la configuración del tipo de contenido.

Este método puede producir todas las excepciones que produce Add(stringname, PageLayoutlayout) plus DocumentToPublishingPageConversionException.