.NET Framework クラス ライブラリ リファレンス

SqlUserDefinedAggregateAttribute クラス

メモ : このクラスは、.NET Framework version 2.0 で新しく追加されたものです。

型をユーザー定義集計として登録する必要があることを示します。この属性には、型を SQL Server に登録する際に使用される物理的な属性を反映した、いくつかのプロパティが格納されます。このクラスは継承できません。

名前空間: Microsoft.SqlServer.Server
アセンブリ: System.Data (system.data.dll 内)
構文

Visual Basic (宣言)

<AttributeUsageAttribute(AttributeTargets.Class Or AttributeTargets.Struct,
 AllowMultiple:=False, Inherited:=False)> _
Public NotInheritable Class
 SqlUserDefinedAggregateAttribute
    Inherits Attribute

Visual Basic (使用法)

Dim instance As SqlUserDefinedAggregateAttribute

C#

[AttributeUsageAttribute(AttributeTargets.Class|AttributeTargets.Struct, AllowMultiple=false,
 Inherited=false)] 
public sealed class SqlUserDefinedAggregateAttribute
 : Attribute

C++

[AttributeUsageAttribute(AttributeTargets::Class|AttributeTargets::Struct, AllowMultiple=false,
 Inherited=false)] 
public ref class SqlUserDefinedAggregateAttribute
 sealed : public Attribute

J#

/** @attribute AttributeUsageAttribute(AttributeTargets.Class|AttributeTargets.Struct,
 AllowMultiple=false, Inherited=false) */
 
public final class SqlUserDefinedAggregateAttribute
 extends Attribute

JScript

AttributeUsageAttribute(AttributeTargets.Class|AttributeTargets.Struct, AllowMultiple=false,
 Inherited=false) 
public final class SqlUserDefinedAggregateAttribute
 extends Attribute

解説

SqlUserDefinedAggregateAttribute カスタム属性の割り当てられたクラス定義には、その定義とバインドされるユーザー定義集計が SQL Server によって作成されます。すべてのユーザー定義集計には、この属性を使って注釈を付ける必要があります。

ユーザー定義集計とその例の詳細については、SQL Server 2005 Books Online の「CLR ユーザー定義集計」を参照してください。

使用例

ユーザー定義集計の SqlUserDefinedAggregateAttribute 属性の例を次に示します。この集計は、カスタムのシリアル化を使用して、シリアル化するときの最大サイズを 8,000 バイトに指定し、null、重複、および順序に対して不変です。

Visual Basic

Imports System
Imports System.Data
Imports System.IO
Imports Microsoft.SqlServer.Server

<Serializable(), SqlUserDefinedAggregate(Microsoft.SqlServer.Server.Format.UserDefined,
 _ 
                                         IsInvariantToNulls:=True, _ 
                                         IsInvariantToDuplicates:=False, _
                                         IsInvariantToOrder:=False, _
                                         MaxByteSize:=8000)> _
Public Class Concatenate
    Implements Microsoft.SqlServer.Server.IBinarySerialize

C#

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


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

継承階層

System.Object
   System.Attribute
    Microsoft.SqlServer.Server.SqlUserDefinedAggregateAttribute

スレッド セーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
SqlUserDefinedAggregateAttribute メンバ
Microsoft.SqlServer.Server 名前空間

---

SqlUserDefinedAggregateAttribute コンストラクタ

メモ : このコンストラクタは、.NET Framework version 2.0 で新しく追加されたものです。

ユーザー定義集計に対する必須の属性。型がユーザー定義集計であり、ユーザー定義集計のストレージ形式を持つことを示します。

名前空間: Microsoft.SqlServer.Server
アセンブリ: System.Data (system.data.dll 内)
構文

Visual Basic (宣言)

Public Sub New ( _
    format As Format _
)

Visual Basic (使用法)

Dim format As Format

Dim instance As New SqlUserDefinedAggregateAttribute(format)

C#

public SqlUserDefinedAggregateAttribute (
    Format format
)

C++

public:
SqlUserDefinedAggregateAttribute (
    Format format
)

J#

public SqlUserDefinedAggregateAttribute (
    Format format
)

JScript

public function SqlUserDefinedAggregateAttribute
 (
    format : Format
)

パラメータ

format

集計のシリアル化形式を表す Format のいずれかの値。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
SqlUserDefinedAggregateAttribute クラス
SqlUserDefinedAggregateAttribute メンバ
Microsoft.SqlServer.Server 名前空間

---

SqlUserDefinedAggregateAttribute フィールド

パブリック フィールド

	名前	説明
	MaxByteSizeValue	集計インスタンスの最大サイズ (バイト)。

参照

関連項目

SqlUserDefinedAggregateAttribute クラス
Microsoft.SqlServer.Server 名前空間

---

SqlUserDefinedAggregateAttribute プロパティ

パブリック プロパティ

	名前	説明
	Format	Format のいずれかのシリアル化形式。
	IsInvariantToDuplicates	集計が複製に対して不変かどうかを示します。
	IsInvariantToNulls	集計が null に対して不変かどうかを示します。
	IsInvariantToOrder	集計が順序に対して不変かどうかを示します。
	IsNullIfEmpty	集計で値が累積されていなかった場合に null 参照 (Visual Basic では Nothing) を返すかどうかを示します。
	MaxByteSize	集計インスタンスの最大サイズ (バイト)。
	Name	集計の名前。
	TypeId	派生クラスに実装されている場合は、この Attribute の一意の識別子を取得します。 ( Attribute から継承されます。)

参照

関連項目

SqlUserDefinedAggregateAttribute クラス
Microsoft.SqlServer.Server 名前空間

---

SqlUserDefinedAggregateAttribute メソッド

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	Equals	オーバーロードされます。 ( Attribute から継承されます。)
	GetCustomAttribute	オーバーロードされます。 アセンブリ、モジュール、型のメンバ、またはメソッド パラメータに適用された指定した型のカスタム属性を取得します。 ( Attribute から継承されます。)
	GetCustomAttributes	オーバーロードされます。 アセンブリ、モジュール、型のメンバ、またはメソッド パラメータに適用されたカスタム属性の配列を取得します。 ( Attribute から継承されます。)
	GetHashCode	このインスタンスのハッシュ コードを返します。 ( Attribute から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	IsDefaultAttribute	派生クラス内でオーバーライドされたときに、このインスタンスの値が派生クラスの既定値かどうかを示します。 ( Attribute から継承されます。)
	IsDefined	オーバーロードされます。 指定した型のカスタム属性が、アセンブリ、モジュール、型のメンバ、またはメソッド パラメータに適用されているかどうかを判断します。 ( Attribute から継承されます。)
	Match	派生クラス内でオーバーライドされたときに、指定したオブジェクトとこのインスタンスが等しいかどうかを示す値を返します。 ( Attribute から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	ToString	現在の Object を表す String を返します。 ( Object から継承されます。)

プロテクト メソッド

	名前	説明
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 ( Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 ( Object から継承されます。)

参照

関連項目

SqlUserDefinedAggregateAttribute クラス
Microsoft.SqlServer.Server 名前空間

---

SqlUserDefinedAggregateAttribute メンバ

型をユーザー定義集計として登録する必要があることを示します。この属性には、型を SQL Server に登録する際に使用される物理的な属性を反映した、いくつかのプロパティが格納されます。このクラスは継承できません。

SqlUserDefinedAggregateAttribute データ型で公開されるメンバを以下の表に示します。

パブリック コンストラクタ

	名前	説明
	SqlUserDefinedAggregateAttribute	ユーザー定義集計に対する必須の属性。型がユーザー定義集計であり、ユーザー定義集計のストレージ形式を持つことを示します。

パブリック フィールド

	名前	説明
	MaxByteSizeValue	集計インスタンスの最大サイズ (バイト)。

パブリック プロパティ

	名前	説明
	Format	Format のいずれかのシリアル化形式。
	IsInvariantToDuplicates	集計が複製に対して不変かどうかを示します。
	IsInvariantToNulls	集計が null に対して不変かどうかを示します。
	IsInvariantToOrder	集計が順序に対して不変かどうかを示します。
	IsNullIfEmpty	集計で値が累積されていなかった場合に null 参照 (Visual Basic では Nothing) を返すかどうかを示します。
	MaxByteSize	集計インスタンスの最大サイズ (バイト)。
	Name	集計の名前。
	TypeId	派生クラスに実装されている場合は、この Attribute の一意の識別子を取得します。(Attribute から継承されます。)

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	Equals	オーバーロードされます。 ( Attribute から継承されます。)
	GetCustomAttribute	オーバーロードされます。 アセンブリ、モジュール、型のメンバ、またはメソッド パラメータに適用された指定した型のカスタム属性を取得します。 (Attribute から継承されます。)
	GetCustomAttributes	オーバーロードされます。 アセンブリ、モジュール、型のメンバ、またはメソッド パラメータに適用されたカスタム属性の配列を取得します。 (Attribute から継承されます。)
	GetHashCode	このインスタンスのハッシュ コードを返します。 (Attribute から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	IsDefaultAttribute	派生クラス内でオーバーライドされたときに、このインスタンスの値が派生クラスの既定値かどうかを示します。 (Attribute から継承されます。)
	IsDefined	オーバーロードされます。 指定した型のカスタム属性が、アセンブリ、モジュール、型のメンバ、またはメソッド パラメータに適用されているかどうかを判断します。 (Attribute から継承されます。)
	Match	派生クラス内でオーバーライドされたときに、指定したオブジェクトとこのインスタンスが等しいかどうかを示す値を返します。 (Attribute から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	ToString	現在の Object を表す String を返します。 (Object から継承されます。)

プロテクト メソッド

	名前	説明
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 (Object から継承されます。)

参照

関連項目

SqlUserDefinedAggregateAttribute クラス
Microsoft.SqlServer.Server 名前空間