ScriptIgnoreAttribute Osztály

Definíció

Névtér:

System.Web.Script.Serialization

Szerelvény:

System.Web.Extensions.dll

Azt adja meg, hogy JavaScriptSerializer nem szerializálja a nyilvános tulajdonságot vagy a nyilvános mezőt. Ez az osztály nem örökölhető.

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

Öröklődés

Object

Attribute

ScriptIgnoreAttribute

Attribútumok

AttributeUsageAttribute

Példák

Az alábbi példa bemutatja, hogyan alkalmazható ScriptIgnoreAttribute a mezőre Comment a nevesített Groupegyéni osztályban. Ez arra utasítja JavaScriptSerializer , hogy hagyja figyelmen kívül a mezőt, amikor az osztály egy példányát JSON formátumba szerializálja.

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

Megjegyzések

Ha egy osztály nyilvános tulajdonságára vagy nyilvános mezőjére vonatkozik ScriptIgnoreAttribute , akkor JavaScriptSerializer figyelmen kívül hagyja vagy kihagyja a tagot, amikor az osztály egy példányát JavaScript Object Notation (JSON) formátumba szerializálja.

A ScriptIgnoreAttribute tulajdonság nincs hatással, ha a ResponseFormat tulajdonság értéke Xml. Ha ugyanezt a viselkedést szeretné használni az XML-formátumra való szerializáláskor, XmlIgnoreAttribute akkor inkább a tulajdonságra vagy a mezőre kell alkalmazni. Ennek az az oka, hogy az osztály szerializálva lesz ahelyettXmlSerializer, hogy a JavaScriptSerializer .

Egy tulajdonságra vagy ScriptIgnoreAttribute mezőre is XmlIgnoreAttribute alkalmazhatja azokat. Ebben az esetben a JSON- és XML-válaszformátumok esetében a tulajdonság vagy a mező figyelmen kívül lesz hagyva.

Az attribútumok használatáról további információt az Attribútumok című témakörben talál.

Konstruktorok

Name	Description
ScriptIgnoreAttribute()	Inicializálja a ScriptIgnoreAttribute osztály új példányát.

Tulajdonságok

Name	Description
ApplyToOverrides	Lekérdezi vagy beállítja, hogy felülbírálja-e a ScriptIgnoreAttributeJavaScriptSerializer nyilvános tulajdonság vagy a nyilvános mező szerializálását.
TypeId	Ha származtatott osztályban implementálják, ehhez egy egyedi azonosítót Attributekap. (Öröklődés forrása Attribute)

Metódusok

Name	Description
Equals(Object)	Olyan értéket ad vissza, amely jelzi, hogy ez a példány egyenlő-e egy adott objektummal. (Öröklődés forrása Attribute)
GetHashCode()	A példány kivonatkódját adja vissza. (Öröklődés forrása Attribute)
GetType()	Lekéri az Type aktuális példányt. (Öröklődés forrása Object)
IsDefaultAttribute()	Ha egy származtatott osztályban felül van bírálva, azt jelzi, hogy a példány értéke-e a származtatott osztály alapértelmezett értéke. (Öröklődés forrása Attribute)
Match(Object)	Származtatott osztály felülírásakor egy olyan értéket ad vissza, amely jelzi, hogy ez a példány egy adott objektummal egyenlő-e. (Öröklődés forrása Attribute)
MemberwiseClone()	Az aktuális Objectpéldány sekély másolatát hozza létre. (Öröklődés forrása Object)
ToString()	Az aktuális objektumot jelképező sztringet ad vissza. (Öröklődés forrása Object)

Explicit interfész-implementációk

Name	Description
_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)	Névkészletet képez le a küldési azonosítók megfelelő készletére. (Öröklődés forrása Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)	Lekéri egy objektum típusadatait, amelyek a felület típusadatainak lekérésére használhatók. (Öröklődés forrása Attribute)
_Attribute.GetTypeInfoCount(UInt32)	Lekéri az objektumok által biztosított típusinformációs felületek számát (0 vagy 1). (Öröklődés forrása Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)	Hozzáférést biztosít az objektumok által közzétett tulajdonságokhoz és metódusokhoz. (Öröklődés forrása Attribute)