SqlUserDefinedAggregateAttribute Klasa

Definicja

Przestrzeń nazw:

Microsoft.Data.SqlClient.Server

Zestaw:

Microsoft.Data.SqlClient.dll

Pakiet:

Microsoft.Data.SqlClient v4.1.0

Wskazuje, że typ powinien być zarejestrowany jako agregacja zdefiniowana przez użytkownika. Właściwości atrybutu odzwierciedlają atrybuty fizyczne używane podczas rejestrowania typu za pomocą SQL Server. Klasa ta nie może być dziedziczona.

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

Dziedziczenie

Attribute

SqlUserDefinedAggregateAttribute

Atrybuty

AttributeUsageAttribute

Przykłady

W poniższym przykładzie przedstawiono SqlUserDefinedAggregateAttribute atrybut agregacji zdefiniowanej przez użytkownika. Agregacja używa serializacji niestandardowej, ma maksymalny rozmiar 8000 bajtów podczas serializacji i jest niezmienny dla wartości null, duplikatów i kolejności.

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

    }
}

Uwagi

SQL Server tworzy agregację zdefiniowaną przez użytkownika, która jest powiązana z definicją SqlUserDefinedAggregateAttribute klasy, która ma atrybut niestandardowy. Każda agregacja zdefiniowana przez użytkownika musi być oznaczona adnotacją za pomocą tego atrybutu.

Aby uzyskać więcej informacji na temat agregacji zdefiniowanych przez użytkownika, zobacz artykuł "CLR User-Defined Agregacje" w witrynie SQL Server 2005 Books Online.

Konstruktory

SqlUserDefinedAggregateAttribute(Format)

Wymagany atrybut w agregacji zdefiniowanej przez użytkownika, używany do wskazania, że dany typ jest agregowaniem zdefiniowanym przez użytkownika i formatem przechowywania agregacji zdefiniowanej przez użytkownika.

Pola

MaxByteSizeValue

Maksymalny rozmiar w bajtach wymagany do przechowywania stanu tego wystąpienia zagregowanego podczas obliczeń.

Właściwości

Format	Format serializacji jako Format.
IsInvariantToDuplicates	Wskazuje, czy agregacja jest niezmienna w przypadku duplikatów.
IsInvariantToNulls	Wskazuje, czy agregacja jest niezmienna do wartości null.
IsInvariantToOrder	Wskazuje, czy agregacja jest niezmienna do kolejności.
IsNullIfEmpty	Wskazuje, czy agregacja zwraca wartość null , jeśli żadne wartości nie zostały skumulowane.
MaxByteSize	Maksymalny rozmiar w bajtach wystąpienia agregowanego.
Name	Nazwa agregacji.