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

Artigo
03/15/2016

NOTA: Esta API agora está obsoleta.

Cria um novo PublishingPage no PublishingPageCollection do PublishingWeb ao converter um documento de origem.

Namespace: Microsoft.SharePoint.Publishing
Assembly: Microsoft.SharePoint.Publishing (em Microsoft.SharePoint.Publishing.dll)

Sintaxe

'Declaração
<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
'Uso
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
)

Parâmetros

newPageName
Tipo: System.String

Nome do novo PublishingPage.

fileToConvert
Tipo: Microsoft.SharePoint.SPFile

Arquivo para converter para obter o conteúdo da página.

transformerId
Tipo: System.Guid

ID de transformador de documento a ser usado para a conversão.

priority
Tipo: Microsoft.SharePoint.Publishing.PageConversionPriority

enumeração PageConversionPriority para a conversão.

Valor retornado

Tipo: Microsoft.SharePoint.Publishing.PublishingPage
Recém-criado PublishingPage.

Exceções

Exceção	Condição
DocumentToPublishingPageConversionException	Se a conversão falha ou encontra problemas que causam o conversor acione. Por exemplo, essa exceção será exibida quando imagens incorporadas obtém colocadas. Essa exceção sempre deve ser capturada pelo chamador. Se o membro de PublishingPage da exceção emitida não for nulo, o problema que faz com que a exceção é um aviso de conversor e a página que pode ser usada com a limitação que ele pode ter problemas de fidelidade potencialmente significativas, dependendo do aviso de conversor.

DocumentToPublishingPageConversionException

Se a conversão falha ou encontra problemas que causam o conversor acione. Por exemplo, essa exceção será exibida quando imagens incorporadas obtém colocadas. Essa exceção sempre deve ser capturada pelo chamador.

Se o membro de PublishingPage da exceção emitida não for nulo, o problema que faz com que a exceção é um aviso de conversor e a página que pode ser usada com a limitação que ele pode ter problemas de fidelidade potencialmente significativas, dependendo do aviso de conversor.

Comentários

Usa o recurso de criação de cliente inteligente para adicionar uma página ao converter um documento especificado em HTML. O recurso de criação de cliente inteligente Especifica as configurações para usar, como qual layout de página a ser usado para a nova página e qual campo para armazenar o HTML convertido no.

O valor de retorno e exceções são idênticas às para a função Add(stringname, PageLayoutlayout) que leva o novo nome e o layout diretamente, com a adição de DocumentToPublishingPageConversionException às vezes é acionada.

Ver também

Referência

PublishingPageCollection classe

PublishingPageCollection membros

Add em sobrecarga

Microsoft.SharePoint.Publishing namespace

Compartilhar via