Compartilhar via

Programação com o namespace Microsoft.HtmlTrans

  • Artigo

Um usuário pode exibição um documento de uma biblioteca documento mesmo se eles ainda não tiver um aplicativo instalado de computador cliente que é capaz de exibir o documento solicitado. Windows SharePoint Services fornece o espaço para nome Microsoft.HtmlTrans N:Microsoft.HtmlTrans como uma infra-estrutura na qual personalizado compilar aplicativos conversor que fornecem uma versão do documento solicitado no local de não reconhecido HTML arquivo binário formato.

Aviso

O recurso HTML Viewer deve ser habilitado em Windows SharePoint Services Central Administration em ordem para usar essa funcionalidade.

O espaço para nome Microsoft.HtmlTrans.Interface Microsoft.HtmlTrans.Interface consiste em duas interfaces, IHtmlTrLoadBalancer e IHtmlTrLauncher. Uma implementação dessas interfaces também depende um arquivo de configuração XML, chamado htmltransinfo.xml , que reside o servidor que esteja execução Windows SharePoint Services.

  • A interface IHtmlTrLoadBalancer IHtmlTrLoadBalancer ajuda a selecionar o servidor no qual executar o personalizado aplicativo conversor.

  • A interface IHtmlTrLauncher IHtmlTrLauncher inicia o personalizado aplicativo conversor e retorna resultados o HTML para Windows SharePoint Services.

  • O arquivo htmltransinfo.xml redireciona a solicitação documento para uma página manipulador, que, em seguida, chama os componentes do balanceador e iniciador carregar. Uma entrada no arquivo de configuração de htmltransinfo.xml Usa o seguinte formato:

                          <HtmlTrInfo>
    <Mapping Extension="ext" AcceptHeader="application/vnd.my-app" HandlerUrl="myapphandler.aspx" ProgId=""/>
</HtmlTrInfo>

Aviso

As alterações feitas para o arquivo htmltransinfo.XML podem ser perdidas quando você atualização Windows SharePoint Services com um pacote serviço ou corrigir a segurança.

Usando o namespace Microsoft.HtmlTrans

A seguinte seqüência de eventos ocorre quando um usuário solicita um documento de um servidor que esteja execução Windows SharePoint Services:

  1. Windows SharePoint Services identifica a extensão arquivo do documento no arquivo htmltransinfo.xml. Se Windows SharePoint Services encontrado, recupera o compatível atributo AcceptHeader AcceptHeader; Se não encontrado, Windows SharePoint Services solicitará que o usuário para baixar o documento.

  2. Windows SharePoint Services verifica o AcceptHeader atributo valor contra o Accept-Header HTTP header da solicitação para ver se o computador cliente reconhece o tipo solicitado documento. Em caso afirmativo, Windows SharePoint Services envia o documento no seu formato nativo.

  3. Windows SharePoint Services também recupera o atributo ProgID ProgId do arquivo Htmltransinfo.xml e tenta aberto o arquivo no computador cliente, usando o componente que é designado pelo ProgId. Se essa tentativa falhar, Windows SharePoint Services continua com o processo conversão HTML.

  4. Se o computador cliente não reconhece o tipo solicitado documento, Windows SharePoint Services solicitará que o usuário: " de Tarefas Pendentes desejar para converter o documento para visualização no navegador? " Se o usuário decidir não converter o documento, Windows SharePoint Services solicita que o usuário para baixar o documento em vez disso.

  5. Se o usuário optar por converter o documento, Windows SharePoint Services encaminha a solicitação para a página manipulador especificada pelo atributo HandlerUrl HandlerUrl no arquivo Htmltransinfo.xml. A página manipulador gerencia o processo conversão e distribui o arquivo convertido para o usuário para visualização no navegador.

A implementação de conversão de documento personalizadas

Para implementar personalizado conversão documento sobre a plataforma Windows SharePoint Services wssnoversshort você deve criar o seguinte:

  • Uma entrada no arquivo Htmltransinfo.xml para tipo de documento.

  • Uma página manipulador que inicia o processo conversão documento e retorna a saída HTML para o usuário.

  • Um conjunto de personalizado componentes conversão.

Você deve escolher entre três métodos para compilar o conjunto de personalizado componentes conversão:

  • Criar personalizado implementações do IHtmlTrLoadBalancer e IHtmlTrLauncher interfaces que podem ser usadas para iniciar um personalizado aplicativo conversor e retornar seus resultados ao Windows SharePoint Services.

  • Criar um conjunto de personalizado conversão componentes que não usam as interfaces Microsoft.HtmlTrans Microsoft.HtmlTrans.

  • Chamar o personalizado implementações do IHtmlTrLoadBalancer e IHtmlTrLauncher interfaces que são fornecidas como parte de Microsoft Office 2003 Editions Resource Kit e fornecem um personalizado aplicativo conversor para a implementação IHtmlTrLauncher IHtmlTrLauncher para chamar.

Consulte também

Conceitos

Os espaços para nome no modelo de objeto de serviços SharePoint do Windows
Guia de Introdução Com programaticamente personalizar uma Web Site SharePoint em Visual Studio