ScriptIgnoreAttribute Classe

Référence

Définition

Espace de noms:: System.Web.Script.Serialization

Assembly:: System.Web.Extensions.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Spécifie que JavaScriptSerializer ne sérialisera pas la propriété publique ou le champ public. Cette classe ne peut pas être héritée.

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

Héritage: Object

Attribute
ScriptIgnoreAttribute

Attributs: AttributeUsageAttribute

Exemples

L’exemple suivant montre comment s’appliquer ScriptIgnoreAttribute au champ dans la Comment classe personnalisée nommée Group. Cela indique JavaScriptSerializer d’ignorer le champ lors de la sérialisation d’une instance de la classe au format 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

Remarques

Si vous appliquez ScriptIgnoreAttribute une propriété publique ou un champ public d’une classe, ignore JavaScriptSerializer ou ignore, le membre lors de la sérialisation d’une instance de la classe au format JSON (JavaScript Object Notation).

La ScriptIgnoreAttribute propriété n’a aucun effet si la ResponseFormat propriété est définie sur Xml. Si vous souhaitez avoir le même comportement lors de la sérialisation au format XML, XmlIgnoreAttribute devez être appliqué à la propriété ou au champ à la place. Cela est dû au fait que la classe est sérialisée à l’aide XmlSerializer au lieu de JavaScriptSerializer.

Vous pouvez également appliquer à la fois ScriptIgnoreAttribute une XmlIgnoreAttribute propriété ou un champ. Dans ce cas, la propriété ou le champ est ignoré pour les formats de réponse JSON et XML.

Pour plus d’informations sur l’utilisation des attributs, consultez Attributs.

Constructeurs

ScriptIgnoreAttribute()

Initialise une nouvelle instance de la classe ScriptIgnoreAttribute.

Propriétés

ApplyToOverrides	Obtient ou définit une valeur indiquant si ScriptIgnoreAttribute doit être substitué afin que JavaScriptSerializer prenne en compte la sérialisation de la propriété publique ou du champ public.
TypeId	Lors de l'implémentation dans une classe dérivée, obtient un identificateur unique pour l'objet Attribute. (Hérité de Attribute)

Méthodes

Equals(Object)	Retourne une valeur qui indique si cette instance est égale à un objet spécifié. (Hérité de Attribute)
GetHashCode()	Retourne le code de hachage de cette instance. (Hérité de Attribute)
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
IsDefaultAttribute()	En cas de substitution dans une classe dérivée, indique si la valeur de cette instance est la valeur par défaut pour la classe dérivée. (Hérité de Attribute)
Match(Object)	En cas de substitution dans une classe dérivée, retourne une valeur indiquant si cette instance équivaut à un objet spécifié. (Hérité de Attribute)
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
ToString()	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object)

Implémentations d’interfaces explicites

_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)	Mappe un jeu de noms avec un jeu correspondant d'identificateurs de dispatch. (Hérité de Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)	Récupère les informations de type pour un objet, qui peuvent être utilisées pour obtenir les informations de type d'une interface. (Hérité de Attribute)
_Attribute.GetTypeInfoCount(UInt32)	Récupère le nombre d'interfaces d'informations de type fourni par un objet (0 ou 1). (Hérité de Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)	Fournit l'accès aux propriétés et aux méthodes exposées par un objet. (Hérité de Attribute)

S’applique à