Compartilhar via


SqlUserDefinedAggregateAttribute Classe

Definição

Indica que o tipo deve ser registrado como uma agregação definida pelo usuário. As propriedades do atributo refletem os atributos físicos usados quando o tipo é registrado no SQL Server. Essa classe não pode ser herdada.

public ref class SqlUserDefinedAggregateAttribute sealed : Attribute
[System.AttributeUsage(System.AttributeTargets.Class | System.AttributeTargets.Struct, AllowMultiple=false, Inherited=false)]
public sealed class SqlUserDefinedAggregateAttribute : Attribute
[<System.AttributeUsage(System.AttributeTargets.Class | System.AttributeTargets.Struct, AllowMultiple=false, Inherited=false)>]
type SqlUserDefinedAggregateAttribute = class
    inherit Attribute
Public NotInheritable Class SqlUserDefinedAggregateAttribute
Inherits Attribute
Herança
SqlUserDefinedAggregateAttribute
Atributos

Exemplos

O exemplo a seguir mostra o SqlUserDefinedAggregateAttribute atributo para uma agregação definida pelo usuário. A agregação usa serialização personalizada, tem um tamanho máximo de 8.000 bytes quando serializada e é invariável para nulos, duplicatas e ordem.

using Microsoft.SqlServer.Server;
using System.IO;
using System.Data.Sql;
using System.Data.SqlTypes;
using System.Text;

[Serializable]
[Microsoft.SqlServer.Server.SqlUserDefinedAggregate(
   Microsoft.SqlServer.Server.Format.UserDefined,
   IsInvariantToNulls = true,
   IsInvariantToDuplicates = false,
   IsInvariantToOrder = false,
   MaxByteSize = 8000)
        ]
public class Concatenate : Microsoft.SqlServer.Server.IBinarySerialize
{

    public void Read(BinaryReader r)
    {

    }

    public void Write(BinaryWriter w)
    {

    }
}

Comentários

SQL Server cria uma agregação definida pelo usuário associada à definição de classe que tem o SqlUserDefinedAggregateAttribute atributo personalizado. Todas as agregações definidas pelo usuário devem ser anotadas com esse atributo.

Confira "Agregações de User-Defined CLR" nos Manuais Online do SQL Server 2005 para obter mais informações sobre agregações e exemplos definidos pelo usuário.

Construtores

SqlUserDefinedAggregateAttribute(Format)

Um atributo necessário em uma agregação definida pelo usuário, usado para indicar que o tipo fornecido é uma agregação definida pelo usuário e indicar também o formato de armazenamento da agregação definida pelo usuário.

Campos

MaxByteSizeValue

O tamanho máximo, em bytes, necessário para armazenar o estado desta instância de agregação durante a computação.

Propriedades

Format

O formato de serialização como um Format.

IsInvariantToDuplicates

Indica se a agregação é invariável em relação a duplicatas.

IsInvariantToNulls

Indica se a agregação é invariável em relação a nulos.

IsInvariantToOrder

Indica se a agregação é invariável em relação à ordem.

IsNullIfEmpty

Indica se a agregação retorna null se nenhum valor foi acumulado.

MaxByteSize

O tamanho máximo, em bytes, da instância da agregação.

Name

O nome da agregação.

Aplica-se a