OptionalFieldAttribute クラス
アセンブリ: mscorlib (mscorlib.dll 内)
構文<AttributeUsageAttribute(AttributeTargets.Field, Inherited:=False)> _ <ComVisibleAttribute(True)> _ Public NotInheritable Class OptionalFieldAttribute Inherits Attribute
[AttributeUsageAttribute(AttributeTargets.Field, Inherited=false)] [ComVisibleAttribute(true)] public sealed class OptionalFieldAttribute : Attribute
[AttributeUsageAttribute(AttributeTargets::Field, Inherited=false)] [ComVisibleAttribute(true)] public ref class OptionalFieldAttribute sealed : public Attribute
解説この属性により、シリアル化可能な型 (SerializableAttribute が適用される型) の新しいフィールドを、BinaryFormatter または SoapFormatter が無視するよう指定できます。これにより、データをシリアル化する旧バージョンのアプリケーション用に作成された型を、型のバージョンに関係なくシリアル化できます。たとえば、フォーマッタが新しいフィールドを含まないバージョンによって作成されたストリームを検出した場合でも、例外はスローされず、旧バージョンの型の既存データが通常どおり処理されます。
継承階層System.Attribute
System.Runtime.Serialization.OptionalFieldAttribute
スレッド セーフ
プラットフォーム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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。
バージョン情報
参照OptionalFieldAttribute コンストラクタ
アセンブリ: mscorlib (mscorlib.dll 内)
構文
プラットフォーム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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。
バージョン情報
参照OptionalFieldAttribute プロパティ
パブリック プロパティ| 名前 | 説明 | |
|---|---|---|
| TypeId | 派生クラスに実装されている場合は、この Attribute の一意の識別子を取得します。 ( Attribute から継承されます。) |
| VersionAdded | このプロパティは予約済みです。 |
参照OptionalFieldAttribute メソッド
パブリック メソッド| 名前 | 説明 | |
|---|---|---|
| Equals | オーバーロードされます。 ( Attribute から継承されます。) |
| GetCustomAttribute | オーバーロードされます。 アセンブリ、モジュール、型のメンバ、またはメソッド パラメータに適用された指定した型のカスタム属性を取得します。 ( Attribute から継承されます。) |
| GetCustomAttributes | オーバーロードされます。 アセンブリ、モジュール、型のメンバ、またはメソッド パラメータに適用されたカスタム属性の配列を取得します。 ( Attribute から継承されます。) |
| GetHashCode | このインスタンスのハッシュ コードを返します。 ( Attribute から継承されます。) |
| GetType | 現在のインスタンスの Type を取得します。 ( Object から継承されます。) |
| IsDefaultAttribute | 派生クラス内でオーバーライドされたときに、このインスタンスの値が派生クラスの既定値かどうかを示します。 ( Attribute から継承されます。) |
| IsDefined | オーバーロードされます。 指定した型のカスタム属性が、アセンブリ、モジュール、型のメンバ、またはメソッド パラメータに適用されているかどうかを判断します。 ( Attribute から継承されます。) |
| Match | 派生クラス内でオーバーライドされたときに、指定したオブジェクトとこのインスタンスが等しいかどうかを示す値を返します。 ( Attribute から継承されます。) |
| ReferenceEquals | 指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。) |
| ToString | 現在の Object を表す String を返します。 ( Object から継承されます。) |
参照OptionalFieldAttribute メンバ
シリアル化ストリームからフィールドを除外できるよう指定することにより、BinaryFormatter および SoapFormatter が例外をスローしないようにします。
OptionalFieldAttribute データ型で公開されるメンバを以下の表に示します。
パブリック コンストラクタ
パブリック プロパティ| 名前 | 説明 | |
|---|---|---|
| TypeId | 派生クラスに実装されている場合は、この Attribute の一意の識別子を取得します。(Attribute から継承されます。) |
| VersionAdded | このプロパティは予約済みです。 |
パブリック メソッド| 名前 | 説明 | |
|---|---|---|
| Equals | オーバーロードされます。 ( Attribute から継承されます。) |
| GetCustomAttribute | オーバーロードされます。 アセンブリ、モジュール、型のメンバ、またはメソッド パラメータに適用された指定した型のカスタム属性を取得します。 (Attribute から継承されます。) |
| GetCustomAttributes | オーバーロードされます。 アセンブリ、モジュール、型のメンバ、またはメソッド パラメータに適用されたカスタム属性の配列を取得します。 (Attribute から継承されます。) |
| GetHashCode | このインスタンスのハッシュ コードを返します。 (Attribute から継承されます。) |
| GetType | 現在のインスタンスの Type を取得します。 (Object から継承されます。) |
| IsDefaultAttribute | 派生クラス内でオーバーライドされたときに、このインスタンスの値が派生クラスの既定値かどうかを示します。 (Attribute から継承されます。) |
| IsDefined | オーバーロードされます。 指定した型のカスタム属性が、アセンブリ、モジュール、型のメンバ、またはメソッド パラメータに適用されているかどうかを判断します。 (Attribute から継承されます。) |
| Match | 派生クラス内でオーバーライドされたときに、指定したオブジェクトとこのインスタンスが等しいかどうかを示す値を返します。 (Attribute から継承されます。) |
| ReferenceEquals | 指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。) |
| ToString | 現在の Object を表す String を返します。 (Object から継承されます。) |
参照- OptionalFieldAttributeのページへのリンク