Etapa 2: Criando um gerenciado-código UDF

Artigo
09/26/2008

Após ter adicionado uma referência a Microsoft.Office.Excel.Server.Udf.dll para seu projeto, o próximo etapa é criar alguns personalizado funções e marca-los com os atributos user-defined function (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 e marca os 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 o atributo Microsoft.Office.Excel.Server.Udf.UdfMethod Microsoft.Office.Excel.Server.Udf.UdfMethod no assembly de UDF serão ignorados, porque eles serão não ser considerados métodos UDF.

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.

Criando UDFs, Uniqueness Database Files

Para adicionar diretivas

Os tipos para usar são definidos no namespace Microsoft.Office.Excel.Server.Udf Microsoft.Office.Excel.Server.Udf. Adicionando um using (ou Imports) diretiva na parte superior do arquivo Class1.cs permitirá que você usar os tipos em Microsoft.Office.Excel.Server.Udf sem precisar totalmente qualificar os tipos no espaço para nome.

Para adicionar esta diretiva, adicionar o seguinte codificar para o início da sua codificar em arquivo de Class1.cs, após using System.Text:
```
using Microsoft.Office.Excel.Server.Udf; 
```

A marca uma classe UDF e métodos

Marcar Class1 como uma classe UDF adicionando o seguinte atributo logo acima classe pública Class1 public class Class1:
```
[UdfClass]
```
Criar uma função que usa um número (do tipo double) e na função, multiplique o número por 9. A função é um método UDF que é não-volátil. Adicione o seguinte codificar para Class1:
```
[UdfMethod]
public double MyDouble(double d)
{
    return d * 9;
}
```
Dica

O valor usar como padrão para o IsVolatile IsVolatile propriedade é false, o que significa que determinado método UDF é não-volátil.Portanto, é suficiente para marca uma não-volátil método UDF como [UdfMethod].Não é necessário a marca-lo como [UdfMethod(IsVolatile = false)].
Criar outra função que retorna o atual data usando o System.DateTime.Today System.DateTime.Today propriedade. A função é um método UDF que é volátil. Adicione o seguinte codificar para Class1:
```
[UdfMethod(IsVolatile = true)]
public DateTime ReturnDateTimeToday()
{
    return (DateTime.Today);
}      
```

Para compilar o projeto

O menu criação, clique em Solução de Compilação .
Você deve localizar assembly SampleUdf.DLL no Diretório onde você salvou seu projeto.

Concluir de código

O seguinte amostra de código é o completo codificar em arquivo de exemplo Class1.cs descrito os procedimentos anteriores.

using System;
using System.Collections.Generic;
using System.Text;
using Microsoft.Office.Excel.Server.Udf;

namespace SampleUdf
{
    [UdfClass]
    public class Class1
    {
        [UdfMethod]
        public double MyDouble(double d)
        {
            return d * 9;
        }  

        [UdfMethod(IsVolatile = true)]
        public DateTime ReturnDateTimeToday()
        {
            return (DateTime.Today);
        }
    }
}

Consulte também

Outros recursos

Walkthrough: desenvolvendo um gerenciado-código UDF
Noções básicas sobre os UDFs dos serviços Excel
Etapa 1: Criar um projeto e adicionando uma referência UDF
Etapa 3: Implantando e ativando UDFs, Uniqueness Database Files
Etapa 4: Teste e chamar UDFs, Uniqueness Database Files de células
Como a: Criar um UDF que chama um serviço da Web

Compartilhar via