OptionalFieldAttribute 類別

.NET Framework 4

其他版本

指定可從序列化 (Serialization) 資料流中遺漏欄位，使 BinaryFormatter 和 SoapFormatter 不會擲回例外狀況。

繼承階層架構

System.Object
System.Attribute
System.Runtime.Serialization.OptionalFieldAttribute

命名空間： System.Runtime.Serialization
組件： mscorlib (在 mscorlib.dll 中)

語法

C++

複製

[ComVisibleAttribute(true)]
[AttributeUsageAttribute(AttributeTargets.Field, Inherited = false)]
public sealed class OptionalFieldAttribute : Attribute

OptionalFieldAttribute 型別會公開下列成員。

建構函式

	名稱	說明
	OptionalFieldAttribute	初始化 OptionalFieldAttribute 類別的新執行個體。

回頁首

屬性

	名稱	說明
	TypeId	在衍生類別中實作時，取得這個 Attribute 的唯一識別項。 (繼承自 Attribute)。
	VersionAdded	這是未使用的保留屬性。

回頁首

方法

	名稱	說明
	Equals	基礎架構。傳回數值，表示這個執行個體是否等於指定的物件。 (繼承自 Attribute)。
	Finalize	允許物件在記憶體回收進行回收之前，嘗試釋放資源並執行其他清除作業。 (繼承自 Object)。
	GetHashCode	傳回這個執行個體的雜湊程式碼。 (繼承自 Attribute)。
	GetType	取得目前執行個體的 Type。 (繼承自 Object)。
	IsDefaultAttribute	在衍生類別中覆寫時，表示這個執行個體的值是否為衍生類別的預設值。 (繼承自 Attribute)。
	Match	在衍生類別中覆寫時，會傳回值，表示這個執行個體是否等於指定物件。 (繼承自 Attribute)。
	MemberwiseClone	建立目前 Object 的淺層複本 (Shallow Copy)。 (繼承自 Object)。
	ToString	傳回表示目前物件的字串。 (繼承自 Object)。

回頁首

明確介面實作

	名稱	說明
	_Attribute.GetIDsOfNames	將一組名稱對應至一組對應的分派識別項 (Dispatch Identifier)。 (繼承自 Attribute)。
	_Attribute.GetTypeInfo	擷取物件的型別資訊，可以用來取得介面的型別資訊。 (繼承自 Attribute)。
	_Attribute.GetTypeInfoCount	擷取物件提供的型別資訊介面數目 (0 或 1)。 (繼承自 Attribute)。
	_Attribute.Invoke	提供物件所公開的屬性和方法的存取權。 (繼承自 Attribute)。

回頁首

備註

這個屬性讓您指定可序列化型別 (套用 SerializableAttribute 的型別) 中的新欄位，由 BinaryFormatter 或 SoapFormatter 忽略。這可允許為序列化資料的舊版應用程式，建立型別的版本相容序列化。例如，當格式子 (Formatter) 遇到不含新欄位的版本所產生的資料流時，不會擲回任何例外狀況，且較舊型別上的現有資料會以正常方式處理。

版本資訊

.NET Framework

支援版本：4、3.5、3.0、2.0

.NET Framework Client Profile

支援版本：4、3.5 SP1

平台

Windows 7, Windows Vista SP1 (含) 以後版本, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (不支援伺服器核心), Windows Server 2008 R2 (SP1 (含) 以後版本支援伺服器核心), Windows Server 2003 SP2

.NET Framework 並不支援各種平台的所有版本。如需支援的版本的清單，請參閱.NET Framework 系統需求。

執行緒安全

這個型別的任何 Public static (在 Visual Basic 中為 Shared) 成員都具備執行緒安全。並非所有的執行個體成員都是安全執行緒。

請參閱

參考

System.Runtime.Serialization 命名空間

本文對您有任何幫助嗎？是否

不正確

不夠深入

需要更多程式碼範例

翻譯需要加強。

(剩餘 2000 個字元)

社群內容新增

常見問題集