ScriptIgnoreAttribute Classe

Definição

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

Herança

Object

Attribute

ScriptIgnoreAttribute

Atributos

AttributeUsageAttribute

Exemplos

O exemplo a seguir demonstra como aplicar ScriptIgnoreAttribute ao Comment campo na classe personalizada chamada Group. Isso instrui JavaScriptSerializer a ignorar o campo ao serializar uma instância da classe para o formato 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

Comentários

Se você aplicar ScriptIgnoreAttribute a uma propriedade pública ou campo público de uma classe, ignorará JavaScriptSerializer ou ignorará o membro ao serializar uma instância da classe para o formato JSON (JavaScript Object Notation).

A ScriptIgnoreAttribute propriedade não terá efeito se a ResponseFormat propriedade estiver definida como Xml. Se você quiser ter o mesmo comportamento ao serializar para o formato XML, XmlIgnoreAttribute deverá ser aplicado à propriedade ou campo em vez disso. Isso ocorre porque a classe será serializada usando XmlSerializer em vez de JavaScriptSerializer.

Você também pode aplicar tanto ScriptIgnoreAttributeXmlIgnoreAttribute a uma propriedade ou campo. Nesse caso, a propriedade ou o campo será ignorado para formatos de resposta JSON e XML.

Para obter mais informações sobre como usar atributos, consulte Atributos.