DesignerSerializationOptionsAttribute Class

Definition

Specifica i flag della serializzazione per una proprietà.Specifies the serialization flags for a property.

public ref class DesignerSerializationOptionsAttribute sealed : Attribute
[System.AttributeUsage(System.AttributeTargets.Field | System.AttributeTargets.Method | System.AttributeTargets.Property, AllowMultiple=false)]
public sealed class DesignerSerializationOptionsAttribute : Attribute
type DesignerSerializationOptionsAttribute = class
    inherit Attribute
Public NotInheritable Class DesignerSerializationOptionsAttribute
Inherits Attribute
Inheritance
DesignerSerializationOptionsAttribute
Attributes

Remarks

DesignerSerializationOptionsAttribute fornisce un hint di vincolo per il form che le finestre di progettazione e le aree di progettazione devono utilizzare quando si interagisce con la proprietà con attributi.DesignerSerializationOptionsAttribute provides a constraint hint for the form that designers and design surfaces should use when interacting with the attributed property. In genere, il motivo è quello di suggerire SerializeAsAttribute.Generally the reason for doing so is to hint SerializeAsAttribute. Questa operazione può essere eseguita nei casi in cui l'interazione con tale proprietà come formato serializzato dal contenuto della stringa ha il rischio di introdurre spazi vuoti non corretti.You might do this in cases where interacting with that property as a content-serialized form of the string has risk of introducing spurious white space. Un caso di esempio in cui DesignerSerializationOptionsAttribute viene applicato per questo motivo è FrameworkElement.Name.An example case where DesignerSerializationOptionsAttribute is applied for this reason is FrameworkElement.Name.

L'utilizzo degli attributi per DesignerSerializationOptionsAttribute supporta l'assegnazione a un metodo.Attribute usage for DesignerSerializationOptionsAttribute supports assigning to a method. In questo modo è possibile dichiarare le opzioni di serializzazione per una proprietà associata XAML, assegnando DesignerSerializationOptionsAttribute sul metodo della funzione di accesso Get che supporta il modello di utilizzo delle proprietà associate.This enables you to declare serialization options for a XAML attached property, by assigning DesignerSerializationOptionsAttribute on the Get accessor method that supports the attached property usage pattern. Un esempio di questa operazione nei tipi WPF è XmlSpace e la relativa funzione di accesso Get GetXmlSpace.An example of this in the WPF types is XmlSpace and its Get accessor GetXmlSpace.

Si noti che DesignerSerializationOptionsAttribute suggerisce il formato di serializzazione desiderato, non se la proprietà è o non è serializzata.Note that DesignerSerializationOptionsAttribute hints the desired serialization form, not whether the property is or is not serialized. Se si desidera influenzare altri aspetti della serializzazione delle proprietà, è possibile utilizzare DesignerSerializationVisibilityAttributeo implementare metodi di ShouldSerialize pattern sulla classe Owner.If you want to influence other aspects of property serialization, you can use DesignerSerializationVisibilityAttribute, or can implement ShouldSerialize pattern methods on the owner class. Per ulteriori informazioni sui modelli di serializzazione .NET generali per la fase di progettazione, vedere Cenni preliminari sulla serializzazione della progettazione.For more information on the general .NET serialization patterns for design time, see Designer Serialization Overview.

Constructors

DesignerSerializationOptionsAttribute(DesignerSerializationOptions)

Inizializza una nuova istanza della classe DesignerSerializationOptionsAttribute.Initializes a new instance of the DesignerSerializationOptionsAttribute class.

Properties

DesignerSerializationOptions

Ottiene DesignerSerializationOptions impostato sull'attributo.Gets the DesignerSerializationOptions set on the attribute.

TypeId

Quando è implementata in una classe derivata, ottiene un identificatore univoco della classe Attribute.When implemented in a derived class, gets a unique identifier for this Attribute.

(Inherited from Attribute)

Methods

Equals(Object)

Restituisce un valore che indica se questa istanza è uguale a un oggetto specificato.Returns a value that indicates whether this instance is equal to a specified object.

(Inherited from Attribute)
GetHashCode()

Restituisce il codice hash relativo a questa istanza.Returns the hash code for this instance.

(Inherited from Attribute)
GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Inherited from Object)
IsDefaultAttribute()

In caso di override in una classe derivata, indica se il valore di questa istanza è il valore predefinito per la classe derivata.When overridden in a derived class, indicates whether the value of this instance is the default value for the derived class.

(Inherited from Attribute)
Match(Object)

Quando è sottoposto a override in una classe derivata, restituisce un valore che indica se questa istanza equivale a un oggetto specificato.When overridden in a derived class, returns a value that indicates whether this instance equals a specified object.

(Inherited from Attribute)
MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Inherited from Object)
ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.Returns a string that represents the current object.

(Inherited from Object)

Explicit Interface Implementations

_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)

Esegue il mapping di un set di nomi a un set corrispondente di ID dispatch.Maps a set of names to a corresponding set of dispatch identifiers.

(Inherited from Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)

Recupera le informazioni sul tipo relative a un oggetto, che possono essere usate per ottenere informazioni sul tipo relative a un'interfaccia.Retrieves the type information for an object, which can be used to get the type information for an interface.

(Inherited from Attribute)
_Attribute.GetTypeInfoCount(UInt32)

Recupera il numero delle interfacce di informazioni sul tipo fornite da un oggetto (0 o 1).Retrieves the number of type information interfaces that an object provides (either 0 or 1).

(Inherited from Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

Fornisce l'accesso a proprietà e metodi esposti da un oggetto.Provides access to properties and methods exposed by an object.

(Inherited from Attribute)

Applies to