ScriptIgnoreAttribute 類別

定義

命名空間:

System.Web.Script.Serialization

組件:

System.Web.Extensions.dll

指定 JavaScriptSerializer 不會將公用屬性或公用欄位序列化。 此類別無法獲得繼承。

public ref class ScriptIgnoreAttribute sealed : Attribute

[System.AttributeUsage(System.AttributeTargets.Field | System.AttributeTargets.Property)]
public sealed class ScriptIgnoreAttribute : Attribute

[System.AttributeUsage(System.AttributeTargets.Field | System.AttributeTargets.Property, AllowMultiple=false, Inherited=true)]
public sealed class ScriptIgnoreAttribute : Attribute

[<System.AttributeUsage(System.AttributeTargets.Field | System.AttributeTargets.Property)>]
type ScriptIgnoreAttribute = class
    inherit Attribute

[<System.AttributeUsage(System.AttributeTargets.Field | System.AttributeTargets.Property, AllowMultiple=false, Inherited=true)>]
type ScriptIgnoreAttribute = class
    inherit Attribute

Public NotInheritable Class ScriptIgnoreAttribute
Inherits Attribute

繼承

Object

Attribute

ScriptIgnoreAttribute

屬性

AttributeUsageAttribute

範例

下列範例示範如何套用 ScriptIgnoreAttribute 至 Comment 名為 Group 的自訂類別中的 欄位。 這會指示 JavaScriptSerializer 將 類別的實例序列化為 JSON 格式時忽略 欄位。

using System;
using System.Web.Script.Serialization;

public class Group
{
    // The JavaScriptSerializer ignores this field.
    [ScriptIgnore]
    public string Comment;

    // The JavaScriptSerializer serializes this field.
    public string GroupName;
}

Imports System.Web.Script.Serialization

Public Class Group
    ' The JavaScriptSerializer ignores this field.
    <ScriptIgnore()> Public Comment As String

    ' The JavaScriptSerializer serializes this field.
    Public GroupName As String
End Class

備註

如果您套用 ScriptIgnoreAttribute 至類別的公用屬性或公用欄位，則會 JavaScriptSerializer 忽略或略過，將類別的實例序列化為 JavaScript 物件標記法時的成員， (JSON) 格式。

如果 ResponseFormat 屬性設定為 Xml ， ScriptIgnoreAttribute 則 不會有任何作用。 如果您想要在序列化為 XML 格式時具有相同的行為， XmlIgnoreAttribute 應該改為套用至 屬性或欄位。 這是因為 類別會使用 XmlSerializer 來序列化，而不是 JavaScriptSerializer 。

您也可以同時 ScriptIgnoreAttribute 將 和 XmlIgnoreAttribute 套用至屬性或欄位。 在此情況下，JSON 和 XML 回應格式將會忽略 屬性或欄位。

如需如何使用屬性的詳細資訊，請參閱 屬性。

建構函式

ScriptIgnoreAttribute()

初始化 ScriptIgnoreAttribute 類別的新執行個體。

屬性

ApplyToOverrides	取得或設定是否要覆寫 ScriptIgnoreAttribute，讓 JavaScriptSerializer 來決定公用屬性或公用欄位的序列化。
TypeId	在衍生類別中實作時，取得這個 Attribute 的唯一識別碼。 (繼承來源 Attribute)

方法

Equals(Object)	傳回值，這個值指出此執行個體是否與指定的物件相等。 (繼承來源 Attribute)
GetHashCode()	傳回這個執行個體的雜湊碼。 (繼承來源 Attribute)
GetType()	取得目前執行個體的 Type。 (繼承來源 Object)
IsDefaultAttribute()	在衍生類別中覆寫時，表示這個執行個體的值是衍生類別的預設值。 (繼承來源 Attribute)
Match(Object)	在衍生類別中覆寫時，會傳回值，表示這個執行個體是否等於指定物件。 (繼承來源 Attribute)
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
ToString()	傳回代表目前物件的字串。 (繼承來源 Object)

明確介面實作

_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)