ScriptIgnoreAttribute Classe

Referência

Definição

Namespace:: System.Web.Script.Serialization

Assembly:: System.Web.Extensions.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Especifica que JavaScriptSerializer não serializará a propriedade pública ou o campo público. Essa classe não pode ser herdada.

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ê se 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 ScriptIgnoreAttribute XmlIgnoreAttribute 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.

Construtores

ScriptIgnoreAttribute()

Inicializa uma nova instância da classe ScriptIgnoreAttribute.

Propriedades

ApplyToOverrides	Informa ou define se ScriptIgnoreAttribute deve ser substituído para que o JavaScriptSerializer considere a serialização do campo público ou da propriedade pública.
TypeId	Quando implementado em uma classe derivada, obtém um identificador exclusivo para este Attribute. (Herdado de Attribute)

Métodos

Equals(Object)	Retorna um valor que indica se essa instância é igual a um objeto especificado. (Herdado de Attribute)
GetHashCode()	Retorna o código hash para a instância. (Herdado de Attribute)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
IsDefaultAttribute()	Quando substituído em uma classe derivada, indica se o valor dessa instância é o valor padrão para a classe derivada. (Herdado de Attribute)
Match(Object)	Quando substituído em uma classe derivada, retorna um valor que indica se essa instância é igual a um objeto especificado. (Herdado de Attribute)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)

Implantações explícitas de interface

_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)	Mapeia um conjunto de nomes para um conjunto correspondente de identificadores de expedição. (Herdado de Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)	Recupera as informações de tipo para um objeto, que pode ser usado para obter as informações de tipo para uma interface. (Herdado de Attribute)
_Attribute.GetTypeInfoCount(UInt32)	Retorna o número de interfaces de informações do tipo que um objeto fornece (0 ou 1). (Herdado de Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)	Fornece acesso a propriedades e métodos expostos por um objeto. (Herdado de Attribute)

Aplica-se a

Partilhar via