OptionalFieldAttribute 類別
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
指定串行化數據流中遺漏字段，讓 BinaryFormatter 和 SoapFormatter 不會擲回例外狀況。
public ref class OptionalFieldAttribute sealed : Attribute[System.AttributeUsage(System.AttributeTargets.Field, Inherited=false)]
[System.Runtime.InteropServices.ComVisible(true)]
public sealed class OptionalFieldAttribute : Attribute[System.AttributeUsage(System.AttributeTargets.Field, Inherited=false)]
public sealed class OptionalFieldAttribute : Attribute[<System.AttributeUsage(System.AttributeTargets.Field, Inherited=false)>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type OptionalFieldAttribute = class
inherit Attribute[<System.AttributeUsage(System.AttributeTargets.Field, Inherited=false)>]
type OptionalFieldAttribute = class
inherit AttributePublic NotInheritable Class OptionalFieldAttribute
Inherits Attribute- 繼承
- 屬性
備註
這個屬性允許你指定可序列化型別（該型別被套用的型別 SerializableAttribute ）中的新欄位會被忽略 BinaryFormatter ，或是 SoapFormatter。 這使得為舊版應用程式序列化資料時所建立的型別，能夠進行版本容忍的序列化。 例如，當格式化器遇到未包含新欄位的版本產生的串流時，不會拋出例外，舊型態的現有資料會正常處理。
建構函式
| 名稱 | Description |
|---|---|
| OptionalFieldAttribute() |
初始化 OptionalFieldAttribute 類別的新執行個體。 |
屬性
| 名稱 | Description |
|---|---|
| TypeId |
在衍生類別中實作時，取得這個 Attribute的唯一標識碼。 (繼承來源 Attribute) |
| VersionAdded |
會取得或設定一個版本號，以指示可選欄位的加入時間。 |
方法
| 名稱 | Description |
|---|---|
| Equals(Object) |
傳回值，這個值表示這個實例是否等於指定的物件。 (繼承來源 Attribute) |
| GetHashCode() |
傳回這個實例的哈希碼。 (繼承來源 Attribute) |
| GetType() |
取得目前實例的 Type。 (繼承來源 Object) |
| IsDefaultAttribute() |
在衍生類別中覆寫時，指出這個實例的值是否為衍生類別的預設值。 (繼承來源 Attribute) |
| Match(Object) |
在衍生類別中覆寫時，傳回值，指出這個實例是否等於指定的物件。 (繼承來源 Attribute) |
| MemberwiseClone() |
建立目前 Object的淺層複本。 (繼承來源 Object) |
| ToString() |
傳回表示目前 物件的字串。 (繼承來源 Object) |
明確介面實作
| 名稱 | Description |
|---|---|
| _Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr) |
將一組名稱對應至一組對應的分派識別項 (Dispatch Identifier)。 (繼承來源 Attribute) |
| _Attribute.GetTypeInfo(UInt32, UInt32, IntPtr) |
擷取 物件的型別資訊，可用來取得介面的類型資訊。 (繼承來源 Attribute) |
| _Attribute.GetTypeInfoCount(UInt32) |
擷取物件提供的類型資訊介面數目 (0 或 1)。 (繼承來源 Attribute) |
| _Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr) |
提供物件所公開屬性和方法的存取權。 (繼承來源 Attribute) |