SqlUserDefinedAggregateAttribute Classe

Riferimento

Definizione

Spazio dei nomi:: Microsoft.SqlServer.Server

Assembly:: System.Data.SqlClient.dll

Assembly:: System.Data.dll

Assembly:: Microsoft.SqlServer.Server.dll

Pacchetto:: System.Data.SqlClient v4.8.5

Pacchetto:: Microsoft.SqlServer.Server v1.0.0

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Indica che il tipo deve essere registrato come aggregato definito dall'utente. Le proprietà dell'attributo riflettono gli attributi fisici utilizzati quando il tipo viene registrato con SQL Server. La classe non può essere ereditata.

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

Ereditarietà: Attribute
SqlUserDefinedAggregateAttribute

Attributi: AttributeUsageAttribute

Esempio

Nell'esempio seguente viene illustrato l'attributo SqlUserDefinedAggregateAttribute per un'aggregazione definita dall'utente. L'aggregazione usa la serializzazione personalizzata, ha una dimensione massima di 8000 byte durante la serializzazione ed è invariante in valori Null, duplicati e ordine.

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)
    {

    }
}

Commenti

SQL Server crea un'aggregazione definita dall'utente associata alla definizione della classe con l'attributo SqlUserDefinedAggregateAttribute personalizzato. Ogni aggregazione definita dall'utente deve essere annotata con questo attributo.

Per altre informazioni sulle aggregazioni definite dall'utente, vedere "CLR User-Defined Aggregates" nella documentazione online di SQL Server 2005.

Costruttori

SqlUserDefinedAggregateAttribute(Format)

Attributo obbligatorio su un aggregato definito dall'utente, utilizzato per indicare che il tipo specificato è un aggregato definito dall'utente e il formato di memorizzazione di tale aggregato.

Campi

MaxByteSizeValue

Dimensione massima, in byte, richiesta per archiviare lo stato di questa istanza dell'aggregazione durante il calcolo.

Proprietà

Format	Formato di serializzazione come Format.
IsInvariantToDuplicates	Indica se l'aggregato è invariato rispetto ai duplicati.
IsInvariantToNulls	Indica se l'aggregato è invariato rispetto ai valori null.
IsInvariantToOrder	Indica se l'aggregato è invariato rispetto all'ordinamento.
IsNullIfEmpty	Indica se l'aggregato restituisce `null` nel caso in cui non siano stati accumulati valori.
MaxByteSize	Dimensione massima, in byte, dell'istanza dell'aggregato.
Name	Nome dell'aggregato.

Si applica a

Condividi tramite