SqlUserDefinedAggregateAttribute Classe

Definição

Namespace:

Microsoft.Data.SqlClient.Server

Assembly:

Microsoft.Data.SqlClient.dll

Pacote:

Microsoft.Data.SqlClient v4.1.0

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

Attribute

SqlUserDefinedAggregateAttribute

Atributos

AttributeUsageAttribute

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.