Compartilhar via

Noções básicas sobre os UDFs dos serviços Excel

  • Artigo

Funções User-defined (UDFs, Uniqueness Database Files) são personalizado funções que estender o cálculo e dados-recursos importação de Excel. Os desenvolvedores criar personalizado pacotes de cálculo para fornecer:

  • Funções que não são compilado em Excel.

  • Implementações personalizadas para interno funções.

  • Dados Personalizados alimentações de herdado ou sem suporte dados fontes e fluxos Application-specific dados.

Os usuários que criam pastas de trabalho podem chamar UDFs, Uniqueness Database Files de uma célula por fórmulas ? de exemplo, "= MyUdf(A1*3.42)" ? exatamente como eles interno chamar funções.

Serviços do Excel UDFs, Uniqueness Database Files lhe dão a capacidade para usar as fórmulas nas células para chamar personalizado funções escritos em código gerenciado e implantados para Microsoft Office do SharePoint Server 2007. Você pode criar UDFs, Uniqueness Database Files para:

  • Chamar personalizado funções matemáticas.

  • Obter dados de personalizado fontes dados em planilhas.

  • Chamar serviços da Web a partir de UDFs, Uniqueness Database Files.

Criando gerenciado-código UDFs, Uniqueness Database Files

Uma maneira fácil de criar um Serviços do Excel gerenciado-codificar UDF é usar o modelo biblioteca de classes Microsoft Visual Studio 2005. Você precisará fazer referência a biblioteca vínculo dinâmico UDF (DLL), Serviços do Excel nomeado Microsoft.Office.Excel.Server.Udf.dll, no seu gerenciado-codificar UDF projeto.

Microsoft.Office.Excel.Server.Udf.DLL tiver sido compilado usando Microsoft .NET Framework 2.0. Se você usar Visual Studio 2003 para criar seu gerenciado-codificar UDF, não será capaz de referência Microsoft.Office.Excel.Server.Udf.dll. Não é possível para um assembly criado com um versão anterior do .NET Framework para fazer referência um assembly criado com .NET Framework 2.0.

Atributos necessários

Para usar personalizado funções em uma classe como uma classe UDF Serviços do Excel esesshort, você deve marca sua classe UDF com o atributo Microsoft.Office.Excel.Server.Udf.UdfClass Microsoft.Office.Excel.Server.Udf.UdfClass. As classes que não são marcados com este atributo no assembly de UDF serão ignorados pelo Serviços de cálculo do Excel. Eles não são considerados como classes UDF Serviços do Excel esesshort.

Para usar personalizado funções em uma classe como métodos UDF Serviços do Excel esesshort, você deve marca seus métodos UDF com o atributo Microsoft.Office.Excel.Server.Udf.UdfMethod Microsoft.Office.Excel.Server.Udf.UdfMethod. Os métodos que não são marcados com este atributo no assembly de UDF serão ignorados porque eles não são considerados serem métodos UDF Serviços do Excel esesshort.

O atributo Microsoft.Office.Excel.Server.Udf.UdfMethod Microsoft.Office.Excel.Server.Udf.UdfMethod possui um IsVolatile IsVolatile propriedade. Você usar o IsVolatile IsVolatile propriedade para especificar um método UDF como voláteis ou não-volátil. O IsVolatile IsVolatile propriedade leva um Boolean valor. O valor usar como padrão é false, o que significa que determinado método UDF é não-volátil.

Local do Microsoft.Office.Excel.Server.Udf.dll

Sobre o computador onde você instalou O Office SharePoint Server 2007, você pode localizar um copiar de Microsoft.Office.Excel.Server.Udf.dll no:

[drive:]\Program Files\Common Files\Microsoft Shared\web server extensions\12\ISAPI

Implantação e segurança

Tipo local de implantação

Conjuntos de Módulos (Assemblies) UDF pode residir em um local Diretório, cache global de assemblies ou compartilhamento de rede. Em um cenário farm, o local caminho Diretório deve ser idêntico entre o farm.

Identificação de conjuntos de módulos (assemblies) UDF

Você pode expor a identidade de um assembly UDF usando a caminho completo ou nome forte do assembly de Serviços de cálculo do Excel para chamar.

De exemplo, você pode usar:

  • C:\UDFs\MySampleUdf.dll

  • \\MyNetworkServer\UDFs\MySampleUdf.dll

  • CompanyName.Hierarchichal.MyUdfNamespace.MyUdfClassName.dll, versão = 1.1.0.0, cultura = en, PublicKeyToken = e8123117d7ba9ae38

Habilitar conjuntos de módulos (assemblies) UDF

Conjuntos de Módulos (Assemblies) UDF está Por padrão desativado.

Cada de confiança Serviços do Excel esesshort localidade na Shared Services Provider (SSP) possui um AllowUdfs AllowUdfs sinalizador.

Dica

O AllowUdfs AllowUdfs sinalizador é indicado pelas funções User-defined User-defined functions allowed na página de Excel Services Trusted File Locations.

O usar como padrão AllowUdfs AllowUdfs valor é false. Se o AllowUdfs AllowUdfs valor for definido como false em uma determinado de confiança localidade, as pastas de trabalho em que de confiança localidade não tem permissão para chamar UDFs, Uniqueness Database Files.

Em ordem para permitir que os UDFs seja chamado de uma de confiança específica localidade, você definir o AllowUdfs AllowUdfs valor como true.

Se o AllowUdfs AllowUdfs valor é false quando uma sessão é iniciado em um pasta de trabalho que tenha UDF chama neste de confiança localidade, as chamadas UDF falhará. Se você alteração de AllowUdfs a true depois que uma sessão foi iniciada, as chamadas UDF também irão falhar. Isso ocorre porque as alterações no AllowUdfs AllowUdfs sinalizador terão efeito sobre o próximo sessão, após o banco de dados configuração tem sido atualizado.

Permitindo que conjuntos de módulos (assemblies) UDF executar

Se desejar administradores para permitir que conjuntos de módulos (assemblies) UDF para executar, eles precisam registrar todos os conjuntos de módulos (assemblies) UDF e habilitar as pastas de trabalho para chamar UDFs, Uniqueness Database Files por configuração True o sinalizador AllowUdfs AllowUdfs para true na de confiança locais.

Recarregar um conjunto de módulos (assembly) UDF

Para recarregar um assembly UDF, você pode executar iisreset ou reiniciar o domínio do aplicativo Serviços de cálculo do Excel esecsshort.

Aviso

Redefinir IIS terminará atual todas as sessões.

Para obter mais informações, consulte Como a: Ativar UDFs, Uniqueness Database Files.

Descarregar um aplicativo a partir da memóriaPara obter mais informações, consulte (https://msdn.microsoft.com/library/default.asp?url=/library/en-us/csvr2002/htm/cs\_mmc\_administering\_myhj.asp).

Permissão de Segurança do Acesso ao Código Padrão para conjuntos de módulos (assemblies) UDF

Por padrão, conjuntos de módulos (assemblies) UDF executar com confiança completa.

Restringir permissão de segurança de acesso de código para conjuntos de módulos (assemblies) UDF

Se você não fizer isso desejar um assembly UDF específica para executar com confiança completa, você deve explicitamente Restringir permissão segurança de acesso a código para esse assembly UDF. Você pode configurar os grupos codificar e restringir permissão usando o .NET Framework 2.0 ferramenta de configuração.

Os desenvolvedores também podem usar os métodos RequestOptional RequestMinimum RequestOptional e em seu codificar para garantir que seus conjuntos de módulos (assemblies) UDF não get mais permissão que eles necessitam.

Para obter mais informações sobre como configurar grupos codificar, as well as o RequestMinimum e métodos RequestOptional RequestOptional, consulte o seguinte artigos em MSDN:

Consulte também

Outros recursos

Walkthrough: desenvolvendo um gerenciado-código UDF
Como a: Criar um UDF que chama um serviço da Web
Perguntas freqüentes sobre os UDFs dos serviços Excel
Arquitetura dos serviços Excel
Alertas de Serviços Excel
Configuração de Serviços Excel Questões e dicas
Práticas recomendadas de Serviços Excel
Como a: um local relação de confiança
Como a: ficar exceções
Como a: Ativar UDFs, Uniqueness Database Files