Estender funções personalizadas com suplementos XLL

Se você tiver suplementos XLL existentes, poderá criar suplementos de função personalizada equivalentes usando a API JavaScript do Excel para estender os recursos da solução para outras plataformas, como o Excel na Web ou em um Mac. No entanto, os suplementos da API JavaScript do Excel não têm todas as funcionalidades disponíveis nos suplementos XLL. Dependendo da funcionalidade que sua solução usa, o suplemento XLL pode fornecer uma experiência melhor no Excel no Windows do que o suplemento API JavaScript do Excel.

Especificar XLL equivalente no manifesto

Para habilitar a compatibilidade com um suplemento XLL existente, identifique o suplemento XLL equivalente no manifesto do suplemento API JavaScript do Excel. O Excel, em seguida, usa as funções de suplemento XLL ao ser executado no Windows, em vez de funções personalizadas do suplemento da API JavaScript do Excel.

Para definir o suplemento XLL equivalente para suas funções personalizadas, especifique FileName o do arquivo XLL. Quando o usuário abre uma pasta de trabalho com funções do arquivo XLL, o Excel converte as funções em funções compatíveis. A pasta de trabalho usa o arquivo XLL quando aberta no Excel no Windows, mas continua a usar funções personalizadas do suplemento API JavaScript do Excel quando aberta na Web ou no Mac.

A configuração do manifesto depende do tipo de manifesto que o suplemento usa.

"extensions" [
  ...
  "alternates" [
    {
      "prefer": {
        "comAddin": {
          "progId": "ContosoCOMAddin"
        },
        "xllCustomFunctions": {
          "fileName": "contosofunctions.xll"
        }
      }
    }
  ]
]

<VersionOverrides>
  ...
  <EquivalentAddins>
    <EquivalentAddin>
      <ProgId>ContosoCOMAddin</ProgId>
      <Type>COM</Type>
    </EquivalentAddin>

    <EquivalentAddin>
      <FileName>contosofunctions.xll</FileName>
      <Type>XLL</Type>
    </EquivalentAddin>
  </EquivalentAddins>
</VersionOverrides>

Comportamento de função personalizada para funções compatíveis com XLL

As funções XLL de um suplemento são convertidas em funções personalizadas compatíveis com XLL quando uma planilha é aberta e há um suplemento equivalente disponível. No próximo salvamento, as funções XLL são gravadas no arquivo em um modo compatível para que funcionem com as funções personalizadas do suplemento XLL e do suplemento API JavaScript do Excel (quando em plataformas sem suporte do XLL).

A tabela a seguir compara recursos entre funções definidas pelo usuário XLL, funções personalizadas compatíveis com XLL e funções personalizadas do suplemento API JavaScript do Excel.

Confira também

• Tornar seu suplemento do Office compatível com um suplemento COM ou VSTO existente
• Tutorial de funções personalizadas do Excel