PackingSize 列挙体

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

PackingSize 列挙体

型をマーシャリングするときのフィールドのメモリ アライメントを規定する 2 つの要素のうち、1 つを指定します。

名前空間: System.Reflection.Emit
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Visual Basic (宣言)

<SerializableAttribute> _
<ComVisibleAttribute(True)> _
Public Enumeration PackingSize

Visual Basic (使用法)

Dim instance As PackingSize

C#

[SerializableAttribute] 
[ComVisibleAttribute(true)] 
public enum PackingSize

C++

[SerializableAttribute] 
[ComVisibleAttribute(true)] 
public enum class PackingSize

J#

/** @attribute SerializableAttribute() */ 
/** @attribute ComVisibleAttribute(true) */ 
public enum PackingSize

JScript

SerializableAttribute 
ComVisibleAttribute(true) 
public enum PackingSize

メンバ

	メンバ名	説明
	Size1	パッキング サイズは 1 バイトです。
	Size128	パッキング サイズは 128 バイトです。
	Size16	パッキング サイズは 16 バイトです。
	Size2	パッキング サイズは 2 バイトです。
	Size32	パッキング サイズは 32 バイトです。
	Size4	パッキング サイズは 4 バイトです。
	Size64	パッキング サイズは 64 バイトです。
	Size8	パッキング サイズは 8 バイトです。
	Unspecified	パッキング サイズは指定されていません。

解説

パッキング サイズは、構成が LayoutKind.Sequential の構造体およびクラスにおいて、フィールドのアライメントを規定します。パッキング サイズは、構造体またはクラスをマーシャリングするときのフィールドのオフセットを規定する 2 つの要素のうちの 1 つです。もう 1 つの要素は、フィールドの有効サイズです。フィールドのオフセットを決定するには、次の計算を行います。

1. 前のフィールドのサイズを前のフィールドのオフセットに加えることによって、オフセットの最小値を計算します。

2. フィールドの通常パッキング サイズを計算します。フィールドが単純なデータ型の場合は、そのサイズを使用します。フィールドが配列の場合は、配列要素のサイズを使用します。フィールド自体が構造体の場合は、構造体のパッキング サイズと、構造体内の最大フィールドのサイズを比較し、いずれか小さい方のサイズを使用します。

3. パッキング サイズと (手順 2 で計算した) フィールドの通常パッキング サイズを比較して、有効なパッキング サイズを計算します。比較の結果、いずれか小さい方の値を使用します。

4. オフセットを計算します。オフセットは、最小値以上で、手順 3 で計算した有効パッキング サイズの倍数となる最初のメモリ位置となります。

メモ
クラスまたは構造体内のすべてのフィールドについてオフセットを計算したら、全体のサイズがパッキング サイズの倍数となるように、パディングが追加されます。

たとえば、byte と long を含んでいるクラスで、パッキング サイズ Size1 を使用している場合、byte フィールドのオフセットは 0 となり、long フィールドのオフセットは 1 となります。パッキング サイズが Size4 の場合、long フィールドのオフセットは 4 となります。2 つの short フィールドを含むクラスで、パッキング サイズが任意の場合、2 番目の short フィールドのオフセットは 2 となります。

メモ
パッキング サイズを変更した結果、フィールドのアライメントがサイズの倍数ではないオフセットになった場合、パフォーマンスが影響を受ける可能性があります。

プラットフォーム

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、1.1、1.0

参照

関連項目
System.Reflection.Emit 名前空間