ScriptIgnoreAttribute Klasa

Definicja

Przestrzeń nazw:

System.Web.Script.Serialization

Zestaw:

System.Web.Extensions.dll

Określa, że JavaScriptSerializer nie będzie serializować właściwości publicznej lub pola publicznego. Klasa ta nie może być dziedziczona.

public ref class ScriptIgnoreAttribute sealed : 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, AllowMultiple=false, Inherited=true)>]
type ScriptIgnoreAttribute = class
    inherit Attribute

Public NotInheritable Class ScriptIgnoreAttribute
Inherits Attribute

Dziedziczenie

Object

Attribute

ScriptIgnoreAttribute

Atrybuty

AttributeUsageAttribute

Przykłady

W poniższym przykładzie pokazano, jak zastosować do ScriptIgnoreAttributeComment pola w klasie niestandardowej o nazwie Group. Spowoduje JavaScriptSerializer to zignorowanie pola podczas serializacji wystąpienia klasy do formatu 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

Uwagi

W przypadku zastosowania ScriptIgnoreAttribute do właściwości publicznej lub pola publicznego klasy JavaScriptSerializer element członkowski jest ignorowany lub pomijany podczas serializacji wystąpienia klasy do formatu JavaScript Object Notation (JSON).

Właściwość ScriptIgnoreAttribute nie będzie miała żadnego wpływu, jeśli właściwość jest ustawiona ResponseFormat na Xmlwartość . Jeśli chcesz mieć takie samo zachowanie podczas serializacji do formatu XML, XmlIgnoreAttribute należy zamiast tego zastosować do właściwości lub pola. Wynika to z tego, że klasa będzie serializowana przy użyciu metody XmlSerializer zamiast JavaScriptSerializer.

Można również zastosować zarówno właściwość ScriptIgnoreAttribute , jak i XmlIgnoreAttribute do właściwości lub pola. W takim przypadku właściwość lub pole zostanie zignorowane dla formatów odpowiedzi JSON i XML.

Aby uzyskać więcej informacji na temat używania atrybutów, zobacz Atrybuty.

Konstruktory

ScriptIgnoreAttribute()

Inicjuje nowe wystąpienie klasy ScriptIgnoreAttribute.

Właściwości

ApplyToOverrides	Pobiera lub ustawia, czy zastąpić ScriptIgnoreAttribute tak, aby JavaScriptSerializer rozważyć serializacji właściwości publicznej lub pola publicznego.
TypeId	Po zaimplementowaniu w klasie pochodnej pobiera unikatowy identyfikator dla tego Attributeelementu . (Odziedziczone po Attribute)

Metody

Equals(Object)	Zwraca wartość wskazującą, czy to wystąpienie jest równe podanemu obiektowi. (Odziedziczone po Attribute)
GetHashCode()	Zwraca wartość skrótu dla tego wystąpienia. (Odziedziczone po Attribute)
GetType()	Type Pobiera wartość bieżącego wystąpienia. (Odziedziczone po Object)
IsDefaultAttribute()	Podczas zastępowania w klasie pochodnej wskazuje, czy wartość tego wystąpienia jest wartością domyślną dla klasy pochodnej. (Odziedziczone po Attribute)
Match(Object)	Po przesłonięciu w klasie pochodnej zwraca wartość wskazującą, czy to wystąpienie jest równe określonemu obiektowi. (Odziedziczone po Attribute)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)

Jawne implementacje interfejsu

_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)	Zestaw nazw jest mapowany na odpowiedni zestaw identyfikatorów wysyłania. (Odziedziczone po Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)	Pobiera informacje o typie dla obiektu, który może służyć do pobierania informacji o typie dla interfejsu. (Odziedziczone po Attribute)
_Attribute.GetTypeInfoCount(UInt32)	Pobiera informację o liczbie typów interfejsów, jakie zawiera obiekt (0 lub 1). (Odziedziczone po Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)	Umożliwia dostęp do właściwości i metod udostępnianych przez obiekt. (Odziedziczone po Attribute)