Attributi CLR correlati a XAML per tipi e librerie personalizzatiXAML-Related CLR Attributes for Custom Types and Libraries

In questo argomento vengono descritti gli attributi di common language runtime (CLR) definiti dai servizi XAML di .NET Framework.This topic describes the common language runtime (CLR) attributes that are defined by .NET Framework XAML Services. Vengono inoltre descritti altri attributi CLR che sono definiti in .NET Framework che dispongono di uno scenario correlati a XAML per gli assembly o tipi di applicazione.It also describes other CLR attributes that are defined in the .NET Framework that have a XAML-related scenario for application to assemblies or types. Assegnazione di attributi assembly, tipi o membri con questi attributi CLR fornisce informazioni sul sistema di tipi XAML correlate ai tipi.Attributing assemblies, types, or members with these CLR attributes provides XAML type system information related to your types. Vengono fornite informazioni per tutti i consumer XAML che utilizza i servizi XAML di .NET Framework per l'elaborazione di flusso del nodo XAML direttamente o tramite il dedicato reader XAML e writer XAML.Information is provided to any XAML consumer that uses .NET Framework XAML Services for processing the XAML node stream directly or through the dedicated XAML readers and XAML writers.

L'utilizzo di attributi CLR comporta che si utilizza per definire i tipi CLR nel suo complesso, in caso contrario tali attributi non sono disponibili.Using CLR attributes entails that you are using the overall CLR to define your types, otherwise such attributes are not available. Se si utilizza CLR per definire il tipo di backup, il contesto dello schema XAML predefinito utilizzato dai writer XAML dei servizi XAML di .NET Framework possa leggere attribuzione CLR tramite la reflection per assembly di supporto.If you use the CLR to define type backing, then the default XAML schema context used by .NET Framework XAML Services XAML writers can read CLR attribution through reflection against backing assemblies.

Nelle sezioni seguenti vengono descritti gli attributi correlati a XAML che è possibile applicare a tipi o membri personalizzati.The following sections describe the XAML-related attributes that you can apply to custom types or custom members. Ogni attributo CLR comunica informazioni relative a un sistema di tipi XAML.Each CLR attribute communicates information that is relevant to a XAML type system. Nel percorso di caricamento, le informazioni degli attributi consentono il reader XAML formare un flusso del nodo XAML valido, o consente al writer XAML di produrre un oggetto grafico valido.In the load path, the attributed information either helps the XAML reader form a valid XAML node stream, or it helps the XAML writer produce a valid object graph. In Salva percorso, le informazioni degli attributi consentono il reader XAML formare un flusso del nodo XAML valido che ricostruisce informazioni sul sistema di tipi XAML; o dichiara hint per la serializzazione o i requisiti per il writer XAML o altri consumer di XAML.In the save path, the attributed information either helps the XAML reader form a valid XAML node stream that reconstitutes XAML type system information; or it declares serialization hints or requirements for the XAML writer or other XAML consumers.

AmbientAttributeAmbientAttribute

Documentazione di riferimento: AmbientAttributeReference Documentation: AmbientAttribute

Si applica a: (classe), proprietà, o get i membri di funzione di accesso che supportano la proprietà associabile.Applies to: Class, property, or get accessor members that support attachable properties.

Argomenti: nessunoArguments: None

AmbientAttribute indica che la proprietà o tutte le proprietà che accettano il tipo con attributo, devono essere interpretate nel concetto di proprietà di ambiente in XAML.AmbientAttribute indicates that the property, or all properties that take the attributed type, should be interpreted under the ambient property concept in XAML. l concetto di ambiente si riferisce al modo in cui i processori XAML determinano i proprietari dei tipi dei membri.The ambient concept relates to how XAML processors determine type owners of members. Una proprietà di ambiente è una proprietà in cui il valore deve essere disponibile nel contesto del parser durante la creazione di un oggetto grafico, ma la ricerca di membro di tipo tipica viene sospesa per impostare la creazione di nodi XAML immediato.An ambient property is a property where the value is expected to be available in the parser context when creating an object graph, but where typical type-member lookup is suspended for the immediate XAML node set being created.

Il concetto di ambiente può essere applicato ai membri associabili, che non sono rappresentati come proprietà in termini di modalità attribuzione CLR definisce AttributeTargets.The ambient concept can be applied to attachable members, which are not represented as properties in terms of how CLR attribution defines AttributeTargets. L'utilizzo di attribuzione del metodo deve essere applicato solo in caso di un get funzione di accesso che supporta l'utilizzo associabile per XAML.The method attribution usage should be applied only in the case of a get accessor that supports attachable usage for XAML.

ConstructorArgumentAttributeConstructorArgumentAttribute

Documentazione di riferimento: ConstructorArgumentAttributeReference Documentation: ConstructorArgumentAttribute

Si applica a: (classe)Applies to: Class

Argomenti: una stringa che specifica il nome della proprietà che corrispondono a un argomento singolo costruttore.Arguments: A string that specifies the name of the property that matches a single constructor argument.

ConstructorArgumentAttribute Specifica che un oggetto può essere inizializzato utilizzando una sintassi del costruttore non predefinito e che una proprietà con il nome specificato fornisce informazioni sulla costruzione.ConstructorArgumentAttribute specifies that an object can be initialized by using a non-default constructor syntax, and that a property of the specified name supplies construction information. Queste informazioni sono utili principalmente per la serializzazione XAML.This information is primarily for XAML serialization. Per altre informazioni, vedere ConstructorArgumentAttribute.For more information, see ConstructorArgumentAttribute.

ContentPropertyAttributeContentPropertyAttribute

Documentazione di riferimento: ContentPropertyAttributeReference Documentation: ContentPropertyAttribute

Si applica a: (classe)Applies to: Class

Argomenti: una stringa che specifica il nome di un membro del tipo con attributo.Arguments: A string that specifies the name of a member of the attributed type.

ContentPropertyAttribute indica che la proprietà denominata dall'argomento deve essere usata come la proprietà di contenuto XAML per quel tipo.ContentPropertyAttribute indicates that the property as named by the argument should serve as the XAML content property for that type. La definizione delle proprietà di contenuto XAML è ereditata da tutti i tipi derivati assegnabili al tipo di definizione.The XAML content property definition inherits to all derived types that are assignable to the defining type. È possibile sostituire la definizione di un tipo derivato specifico applicando ContentPropertyAttribute sullo specifico tipo derivato.You can override the definition on a specific derived type by applying ContentPropertyAttribute on the specific derived type.

Per la proprietà che funge da proprietà di contenuto XAML, elemento di proprietà tag per la proprietà può essere omesso nell'utilizzo di XAML.For the property that serves as the XAML content property, property element tagging for the property can be omitted in the XAML usage. In genere, specificare le proprietà di contenuto XAML che alzare di livello un markup XAML semplificato per i modelli di contenuto e contenuto.Typically, you designate XAML content properties that promote a streamlined XAML markup for your content and containment models. Poiché solo un membro può essere definito come proprietà di contenuto XAML, è talvolta necessario scelte di progettazione per rendere relative del contenitore delle proprietà di un tipo devono essere designate come proprietà di contenuto XAML.Because only one member can be designated as the XAML content property, you sometimes have design choices to make regarding which of several container properties of a type should be designated as the XAML content property. Proprietà del contenitore deve essere utilizzata con gli elementi di proprietà espliciti.The other container properties must be used with explicit property elements.

Nel flusso del nodo XAML, le proprietà di contenuto XAML producono ancora StartMember e EndMember nodi, utilizzando il nome della proprietà per il XamlMember.In the XAML node stream, XAML content properties still produce StartMember and EndMember nodes, using the name of the property for the XamlMember. Per determinare se il membro è la proprietà di contenuto XAML, esaminare il XamlType valore il StartObject posizionare e ottenere il valore di ContentProperty.To determine whether a member is the XAML content property, examine the XamlType value from the StartObject position and obtain the value of ContentProperty.

ContentWrapperAttributeContentWrapperAttribute

Documentazione di riferimento: ContentWrapperAttributeReference Documentation: ContentWrapperAttribute

Si applica a: (classe), in particolare i tipi di raccolta.Applies to: Class, specifically collection types.

Argomenti: A Type che specifica il tipo da utilizzare come tipo di wrapper del contenuto per il contenuto esterno.Arguments: A Type that specifies the type to use as the content wrapper type for foreign content.

ContentWrapperAttribute Specifica uno o più tipi nel tipo di raccolta associato che verrà utilizzato per eseguire il wrapping di contenuto esterno.ContentWrapperAttribute specifies one or more types on the associated collection type that will be used to wrap foreign content. Contenuto esterno si riferisce ai casi in cui i vincoli di sistema di tipo al tipo della proprietà di contenuto non acquisiscono tutti i possibili casi di contenuto che sarà possibile supportare l'utilizzo della sintassi XAML per il tipo proprietario.Foreign content refers to cases where the type system constraints on the type of the content property do not capture all of the possible content cases that XAML usage for the owning type would support. Ad esempio, il supporto XAML per il contenuto di un determinato tipo può supportare le stringhe in un oggetto generico fortemente tipizzato Collection<T>.For example, XAML support for content of a particular type might support strings in a strongly typed generic Collection<T>. Wrapper del contenuto sono utili per la migrazione di convenzioni del markup preesistenti nella concezione XAML di valori assegnabili per le raccolte, ad esempio la migrazione di modelli di contenuto correlati al testo.Content wrappers are useful for migrating preexisting markup conventions into XAML's conception of assignable values for collections, such as migrating text-related content models.

Per specificare più di un tipo di wrapper del contenuto, applicare l'attributo più volte.To specify more than one content wrapper type, apply the attribute multiple times.

DependsOnAttributeDependsOnAttribute

Documentazione di riferimento: DependsOnAttributeReference Documentation: DependsOnAttribute

Si applica a: proprietàApplies to: Property

Argomenti: una stringa che specifica il nome di un altro membro del tipo con attributo.Arguments: A string that specifies the name of another member of the attributed type.

DependsOnAttribute indica che la proprietà con attributa dipende dal valore di un'altra proprietà.DependsOnAttribute indicates that the attributed property depends on the value of another property. L'applicazione di questo attributo a una definizione di proprietà garantisce che le proprietà dipendenti vengono elaborate prima in scrittura di oggetti XAML.Applying this attribute to a property definition ensures that the dependent properties are processed first in XAML object writing. Utilizzi di DependsOnAttribute specificano i casi eccezionali di proprietà sui tipi in cui deve essere seguire un ordine specifico di analisi per la creazione di un oggetto valido.Usages of DependsOnAttribute specify the exceptional cases of properties on types where a specific order of parsing must be followed for valid object creation.

È possibile applicare più DependsOnAttribute case per una definizione di proprietà.You can apply multiple DependsOnAttribute cases to a property definition.

MarkupExtensionReturnTypeAttributeMarkupExtensionReturnTypeAttribute

Documentazione di riferimento: MarkupExtensionReturnTypeAttributeReference Documentation: MarkupExtensionReturnTypeAttribute

Si applica a: classe, che deve essere un MarkupExtension tipo derivato.Applies to: Class, which is expected to be a MarkupExtension derived type.

Argomenti: A Type che specifica il tipo più preciso per prevedere come il ProvideValue risultato il con attributi MarkupExtension.Arguments: A Type that specifies the most precise type to expect as the ProvideValue result of the attributed MarkupExtension.

Per ulteriori informazioni, vedere estensioni di Markup per XAML Overview.For more information, see Markup Extensions for XAML Overview.

NameScopePropertyAttributeNameScopePropertyAttribute

Documentazione di riferimento: NameScopePropertyAttributeReference Documentation: NameScopePropertyAttribute

Si applica a: (classe)Applies to: Class

Argomenti: supporta due forme di attribuzione di:Arguments: Supports two forms of attribution:

  • Stringa che specifica il nome di una proprietà del tipo con attributi.A string that specifies the name of a property on the attributed type.

  • Una stringa che specifica il nome di una proprietà e un Type per il tipo che definisce la proprietà denominata.A string that specifies the name of a property, and a Type for the type that defines the named property. Questo modulo consente di specificare un membro associabile come proprietà namescope XAML.This form is for specifying an attachable member as the XAML namescope property.

NameScopePropertyAttribute Specifica una proprietà che fornisce il valore di ambito dei nomi XAML per la classe con attributi.NameScopePropertyAttribute specifies a property that provides the XAML namescope value for the attributed class. La proprietà di ambito dei nomi XAML deve fare riferimento a un oggetto che implementa INameScope e mantiene il namescope XAML effettivo, il relativo archivio e il relativo comportamento.The XAML namescope property is expected to reference an object that implements INameScope and holds the actual XAML namescope, its store, and its behavior.

RuntimeNamePropertyAttributeRuntimeNamePropertyAttribute

Documentazione di riferimento: RuntimeNamePropertyAttributeReference Documentation: RuntimeNamePropertyAttribute

Si applica a: (classe)Applies to: Class

Argomenti: una stringa che specifica il nome della proprietà name di runtime del tipo con attributi.Arguments: A string that specifies the name of the run-time name property on the attributed type.

RuntimeNamePropertyAttribute segnala una proprietà del tipo con attributo che è mappata a XAML direttiva X:Name.RuntimeNamePropertyAttribute reports a property of the attributed type that maps to the XAML x:Name Directive. La proprietà deve essere di tipo String e deve essere di lettura/scrittura.The property must be of type String and must be read/write.

La definizione è ereditata da tutti i tipi derivati assegnabili al tipo di definizione.The definition inherits to all derived types that are assignable to the defining type. È possibile sostituire la definizione di un tipo derivato specifico applicando RuntimeNamePropertyAttribute sullo specifico tipo derivato.You can override the definition on a specific derived type by applying RuntimeNamePropertyAttribute on the specific derived type.

TrimSurroundingWhitespaceAttributeTrimSurroundingWhitespaceAttribute

Documentazione di riferimento: TrimSurroundingWhitespaceAttributeReference Documentation: TrimSurroundingWhitespaceAttribute

Si applica a: tipiApplies to: Types

Argomenti: nessuno.Arguments: None.

TrimSurroundingWhitespaceAttribute viene applicato a tipi specifici che potrebbero essere visualizzati come elementi figlio all'interno di spazi vuoti significativi contenuto (contenuto di una raccolta contenente WhitespaceSignificantCollectionAttribute).TrimSurroundingWhitespaceAttribute is applied to specific types that might appear as child elements within whitespace significant content (content held by a collection that has WhitespaceSignificantCollectionAttribute). TrimSurroundingWhitespaceAttribute è importante soprattutto per il salvataggio percorso, ma è disponibile nel sistema di tipi XAML nel percorso di caricamento esaminando XamlType.TrimSurroundingWhitespace.TrimSurroundingWhitespaceAttribute is mainly relevant to the save path, but is available in the XAML type system in the load path by examining XamlType.TrimSurroundingWhitespace. Per ulteriori informazioni, vedere elaborazione degli spazi vuoti in XAML.For more information, see Whitespace Processing in XAML.

TypeConverterAttributeTypeConverterAttribute

Documentazione di riferimento: TypeConverterAttributeReference Documentation: TypeConverterAttribute

Si applica a: (classe), proprietà, metodo (l'unico caso metodo XAML valido è un get funzione di accesso che supporta un membro associabile).Applies to: Class, property, method (the only XAML-valid method case is a get accessor that supports an attachable member).

Argomenti: il Type del TypeConverter.Arguments: The Type of the TypeConverter.

TypeConverterAttribute in un file XAML contesto fa riferimento a un oggetto personalizzato TypeConverter.TypeConverterAttribute in a XAML context references a custom TypeConverter. Questo TypeConverter fornisce il comportamento di conversione di tipi per tipi personalizzati o membri di quel tipo.This TypeConverter provides type conversion behavior for custom types, or members of that type.

Si applica il TypeConverterAttribute attributo per il tipo di implementazione del convertitore di tipi di riferimento.You apply the TypeConverterAttribute attribute to your type, referencing your type converter implementation. È possibile definire i convertitori di tipi per XAML su classi, strutture o interfacce.You can define type converters for XAML on classes, structures, or interfaces. Non è necessario fornire la conversione di tipo per le enumerazioni, che la conversione è abilitata in modo nativo.You do not need to provide type conversion for enumerations, that conversion is enabled natively.

Il convertitore di tipi deve essere in grado di convertire una stringa che viene utilizzata per il testo di inizializzazione nel markup o gli attributi nel tipo di destinazione.Your type converter should be able to convert from a string that is used for attributes or initialization text in markup, into your intended destination type. Per ulteriori informazioni, vedere TypeConverters and XAML.For more information, see TypeConverters and XAML.

Anziché applicare a tutti i valori di un tipo, un comportamento del convertitore di tipi per XAML può essere stabilito anche in una proprietà specifica.Rather than applying to all values of a type, a type converter behavior for XAML can also be established on a specific property. In questo caso, applicano TypeConverterAttribute alla definizione della proprietà (la definizione esterna, non la specifica get e set definizioni).In this case, you apply TypeConverterAttribute to the property definition (the outer definition, not the specific get and set definitions).

Un comportamento del convertitore di tipi per l'utilizzo XAML di un membro associabile personalizzato può essere assegnato applicando TypeConverterAttribute per il get funzione di accesso di metodo che supporta l'utilizzo di XAML.A type converter behavior for XAML usage of a custom attachable member can be assigned by applying TypeConverterAttribute to the get method accessor that supports the XAML usage.

Simile a TypeConverter, TypeConverterAttribute era inclusa in .NET Framework precedenti all'introduzione di XAML e il modello del tipo di convertitore serviva ad altri scopi.Similar to TypeConverter, TypeConverterAttribute existed in the .NET Framework prior to the existence of XAML, and the type converter model served other purposes. Per fare riferimento e utilizzare TypeConverterAttribute, è necessario completamente qualificarlo o fornire un using istruzione per System.ComponentModel.In order to reference and use TypeConverterAttribute, you must fully qualify it or provide a using statement for System.ComponentModel. È inoltre necessario includere l'assembly di sistema del progetto.You must also include the System assembly in your project.

UidPropertyAttributeUidPropertyAttribute

Documentazione di riferimento: UidPropertyAttributeReference Documentation: UidPropertyAttribute

Si applica a: (classe)Applies to: Class

Argomenti: una stringa che fa riferimento la proprietà pertinente in base al nome.Arguments: A string that references the relevant property by name.

Indica la proprietà di una classe CLR che rappresenta l'alias di direttiva X:UID.Indicates the CLR property of a class that aliases the x:Uid Directive.

UsableDuringInitializationAttributeUsableDuringInitializationAttribute

Documentazione di riferimento: UsableDuringInitializationAttributeReference Documentation: UsableDuringInitializationAttribute

Si applica a: (classe)Applies to: Class

Argomenti: un valore booleano.Arguments: A Boolean. Se utilizzato per scopi previsti dell'attributo, questo deve sempre essere specificato come true.If used for the attribute's intended purpose, this should always be specified as true.

Indica se questo tipo viene creato in base alla gerarchia durante la creazione del grafico di oggetti XAML.Indicates whether this type is built top-down during XAML object graph creation. Questo è un concetto avanzato, è probabile che è strettamente correlato alla definizione del modello di programmazione.This is an advanced concept, which is probably closely related to the definition of your programming model. Per altre informazioni, vedere UsableDuringInitializationAttribute.For more information, see UsableDuringInitializationAttribute.

ValueSerializerAttributeValueSerializerAttribute

Documentazione di riferimento: ValueSerializerAttributeReference Documentation: ValueSerializerAttribute

Si applica a: (classe), proprietà, metodo (l'unico caso metodo XAML valido è un get funzione di accesso che supporta un membro associabile).Applies to: Class, property, method (the only XAML-valid method case is a get accessor that supports an attachable member).

Argomenti: A Type che specifica la classe di supporto valore serializzatore da utilizzare quando si serializza tutte le proprietà del tipo con attributo o le specifiche attribuito proprietà.Arguments: A Type that specifies the value serializer support class to use when serializing all properties of the attributed type, or the specific attributed property.

ValueSerializer Specifica una classe di serializzazione di valori che richiede più lo stato e il contesto rispetto a un TypeConverter does.ValueSerializer specifies a value serialization class that requires more state and context than a TypeConverter does. ValueSerializer è possibile associare a un membro associabile applicando la ValueSerializerAttribute attributo statica get metodo della funzione di accesso per il membro associabile.ValueSerializer can be associated with an attachable member by applying the ValueSerializerAttribute attribute on the static get accessor method for the attachable member. La serializzazione di valori è applicabile anche per le enumerazioni, interfacce e strutture, ma non per i delegati.Value serialization is also applicable for enumerations, interfaces and structures, but not for delegates.

WhitespaceSignificantCollectionAttributeWhitespaceSignificantCollectionAttribute

Documentazione di riferimento: WhitespaceSignificantCollectionAttributeReference Documentation: WhitespaceSignificantCollectionAttribute

Si applica a: (classe), in particolare i tipi di raccolta previste per ospitare contenuto misto, in cui lo spazio vuoto attorno agli elementi oggetto potrebbe essere significativo per la rappresentazione dell'interfaccia utente.Applies to: Class, specifically collection types that are expected to host mixed content, where white space around object elements might be significant for UI representation.

Argomenti: nessuno.Arguments: None.

WhitespaceSignificantCollectionAttribute indica che un tipo di raccolta deve essere elaborato come significativa di spazi vuoti da un processore XAML, che influisce sulla costruzione di nodi di valore del flusso di nodi XAML all'interno della raccolta.WhitespaceSignificantCollectionAttribute indicates that a collection type should be processed as whitespace significant by a XAML processor, which influences the construction of the XAML node stream's value nodes within the collection. Per ulteriori informazioni, vedere elaborazione degli spazi vuoti in XAML.For more information, see Whitespace Processing in XAML.

XamlDeferLoadAttributeXamlDeferLoadAttribute

Documentazione di riferimento: XamlDeferLoadAttributeReference Documentation: XamlDeferLoadAttribute

Si applica a: (classe), proprietà.Applies to: Class, property.

Argomenti: attribuzione supporta due form tipi sotto forma di stringhe o tipi come Type.Arguments: Supports two attribution forms types as strings, or types as Type. Vedere XamlDeferLoadAttribute.See XamlDeferLoadAttribute.

Indica che una classe o proprietà ha un utilizzo del caricamento posticipato per XAML (ad esempio, un comportamento del modello) e restituisce la classe che consente tale comportamento e il relativo tipo di contenuto/destinazione.Indicates that a class or property has a deferred load usage for XAML (such as a template behavior), and reports the class that enables the deferring behavior and its destination/content type.

XamlSetMarkupExtensionAttributeXamlSetMarkupExtensionAttribute

Documentazione di riferimento: XamlSetMarkupExtensionAttributeReference Documentation: XamlSetMarkupExtensionAttribute

Si applica a: (classe)Applies to: Class

Argomenti: denomina il callback.Arguments: Names the callback.

Indica che una classe è possibile utilizzare un'estensione di markup per fornire un valore per uno o più delle relative proprietà e fa riferimento a un gestore che chiami un writer XAML prima di eseguire un'operazione di impostazione di estensione di markup su qualsiasi proprietà della classe.Indicates that a class can use a markup extension to provide a value for one or more of its properties, and references a handler that a XAML writer should call before performing a markup extension set operation on any property of the class.

XamlSetTypeConverterAttributeXamlSetTypeConverterAttribute

Documentazione di riferimento: XamlSetTypeConverterAttributeReference Documentation: XamlSetTypeConverterAttribute

Si applica a: (classe)Applies to: Class

Argomenti: denomina il callback.Arguments: Names the callback.

Indica che una classe è possibile usare un convertitore di tipi per fornire un valore per uno o più delle relative proprietà e fa riferimento a un gestore che chiami un writer XAML prima di eseguire un'operazione di impostazione di convertitore di tipo su qualsiasi proprietà della classe.Indicates that a class can use a type converter to provide a value for one or more of its properties, and references a handler that a XAML writer should call before performing a type converter set operation on any property of the class.

XmlLangPropertyAttributeXmlLangPropertyAttribute

Documentazione di riferimento: XmlLangPropertyAttributeReference Documentation: XmlLangPropertyAttribute

Si applica a: (classe)Applies to: Class

Argomenti: una stringa che specifica il nome della proprietà da alias da xml:lang nel tipo con attributo.Arguments: A string that specifies the name of the property to alias to xml:lang on the attributed type.

XmlLangPropertyAttribute segnala una proprietà del tipo con attributo che viene eseguito il mapping al codice XML lang direttiva.XmlLangPropertyAttribute reports a property of the attributed type that maps to the XML lang directive. La proprietà non è di tipo String, ma deve essere assegnabile da una stringa (ad esempio mediante l'associazione di un convertitore di tipi con il tipo della proprietà o con la proprietà specifica).The property is not necessarily of type String, but must be assignable from a string (this could be accomplished by associating a type converter with the property's type, or with the specific property). La proprietà deve essere di lettura/scrittura.The property must be read/write.

Lo scenario per il mapping xml:lang è, in modo che un modello a oggetti runtime possa accedere alle informazioni sul linguaggio XML specificato senza alcuna elaborazione specifica con un oggetto XMLDOM.The scenario for mapping xml:lang is so that a runtime object model has access to XML-specified language information without specifically processing with an XMLDOM.

La definizione è ereditata da tutti i tipi derivati assegnabili al tipo di definizione.The definition inherits to all derived types that are assignable to the defining type. È possibile sostituire la definizione di un tipo derivato specifico applicando XmlLangPropertyAttribute sullo specifico tipo, derivato Sebbene sia uno scenario comune.You can override the definition on a specific derived type by applying XmlLangPropertyAttribute on the specific derived type, although that is an uncommon scenario.

Nelle sezioni seguenti vengono descritti gli attributi correlati a XAML che non vengono applicati a tipi o le definizioni dei membri, ma vengono invece applicati agli assembly.The following sections describe the XAML-related attributes that are not applied to types or member definitions, but are instead applied to assemblies. Questi attributi sono pertinenti per l'obiettivo complessivo della definizione di una libreria che contiene i tipi personalizzati da utilizzare in XAML.These attributes are pertinent to the overall goal of defining a library that contains custom types to use in XAML. Alcuni degli attributi non influiscono necessariamente il flusso del nodo XAML direttamente, ma vengono passati nel flusso del nodo per altri consumer di utilizzare.Some of the attributes do not necessarily influence the XAML node stream directly, but are passed on in the node stream for other consumers to use. I consumer per le informazioni includono gli ambienti di progettazione o i processi di serializzazione che necessitano di informazioni dello spazio dei nomi XAML e sul prefisso associato.Consumers for the information include design environments or serialization processes that need XAML namespace information and associated prefix information. Un contesto dello schema XAML (incluso il valore predefinito di servizi XAML di .NET Framework) inoltre utilizza queste informazioni.A XAML schema context (including the .NET Framework XAML Services default) also uses this information.

XmlnsCompatibleWithAttributeXmlnsCompatibleWithAttribute

Documentazione di riferimento: XmlnsCompatibleWithAttributeReference Documentation: XmlnsCompatibleWithAttribute

Argomenti:Arguments:

  • Stringa che specifica l'identificatore dello spazio dei nomi XAML da classificare.A string that specifies the identifier of the XAML namespace to subsume.

  • Stringa che specifica l'identificatore dello spazio dei nomi XAML che possono includere lo spazio dei nomi XAML dell'argomento precedente.A string that specifies the identifier of the XAML namespace that can subsume the XAML namespace from the previous argument.

XmlnsCompatibleWithAttribute Specifica che uno spazio dei nomi XAML può essere sostituito da un altro spazio dei nomi XAML.XmlnsCompatibleWithAttribute specifies that a XAML namespace can be subsumed by another XAML namespace. In genere, viene indicato lo spazio dei nomi XAML classificato in definita in precedenza XmlnsDefinitionAttribute.Typically, the subsuming XAML namespace is indicated in a previously defined XmlnsDefinitionAttribute. Questa tecnica può essere utilizzato per il controllo delle versioni di un vocabolario XAML in una libreria e per renderlo compatibile con markup precedentemente definito per il vocabolario della versione precedente.This technique can be used for versioning a XAML vocabulary in a library and to make it compatible with previously defined markup against the earlier versioned vocabulary.

XmlnsDefinitionAttributeXmlnsDefinitionAttribute

Documentazione di riferimento: XmlnsDefinitionAttributeReference Documentation: XmlnsDefinitionAttribute

Argomenti:Arguments:

  • Stringa che specifica l'identificatore dello spazio dei nomi XAML per definire.A string that specifies the identifier of the XAML namespace to define.

  • Stringa che i nomi di uno spazio dei nomi CLR.A string that names a CLR namespace. Lo spazio dei nomi CLR deve definire i tipi pubblici nell'assembly e almeno uno dei tipi dello spazio dei nomi CLR deve essere destinato a utilizzo della sintassi XAML.The CLR namespace should define public types in your assembly, and at least one of the CLR namespace types should be intended for XAML usage.

XmlnsDefinitionAttribute Specifica un mapping di un singolo assembly tra uno spazio dei nomi XAML e uno spazio dei nomi CLR che viene quindi usato per la risoluzione del tipo da un writer di oggetti XAML o il contesto dello schema XAML.XmlnsDefinitionAttribute specifies a mapping on a per-assembly basis between a XAML namespace and a CLR namespace, which is then used for type resolution by a XAML object writer or XAML schema context.

Più XmlnsDefinitionAttribute può essere applicato a un assembly.More than one XmlnsDefinitionAttribute can be applied to an assembly. Questa operazione può essere eseguita per qualsiasi combinazione dei seguenti motivi:This might be done for any combination of the following reasons:

  • La progettazione della libreria contiene più spazi dei nomi CLR per l'organizzazione logica di accesso alle API di runtime; Tuttavia, si desidera che tutti i tipi in tali spazi dei nomi affinché possa essere usato con XAML facendo riferimento allo stesso spazio dei nomi XAML.The library design contains multiple CLR namespaces for logical organization of run-time API access; however, you want all types in those namespaces to be XAML-usable by referencing the same XAML namespace. In questo caso, si applicano diversi XmlnsDefinitionAttribute attributi utilizzando lo stesso XmlNamespace valore ma diversi ClrNamespace valori.In this case, you apply several XmlnsDefinitionAttribute attributes using the same XmlNamespace value but different ClrNamespace values. Ciò è particolarmente utile se si siano definendo i mapping per lo spazio dei nomi XAML del framework o dell'applicazione intende lo spazio dei nomi XAML predefinito di uso comune.This is especially useful if you are defining mappings for the XAML namespace that your framework or application intends to be the default XAML namespace in common usage.

  • La progettazione della libreria contiene più spazi dei nomi CLR e si desidera una separazione di spazio dei nomi XAML intenzionale tra gli utilizzi dei tipi negli spazi dei nomi CLR.The library design contains multiple CLR namespaces, and you want a deliberate XAML namespace separation between the usages of types in those CLR namespaces.

  • Definire uno spazio dei nomi CLR nell'assembly e si desidera che sia accessibile attraverso più di uno spazio dei nomi XAML.You define a CLR namespace in the assembly, and you want it to be accessible through more than one XAML namespace. Questo scenario si verifica quando si prevede di supportare più vocabolari con la stessa codebase.This scenario occurs when you are supporting multiple vocabularies with the same codebase.

  • Supporto del linguaggio XAML definite in uno o più spazi dei nomi CLR.You define XAML language support in one or more CLR namespaces. Per questo motivo, il XmlNamespace il valore deve essere http://schemas.microsoft.com/winfx/2006/xaml.For these, the XmlNamespace value should be http://schemas.microsoft.com/winfx/2006/xaml.

XmlnsPrefixAttributeXmlnsPrefixAttribute

Documentazione di riferimento: XmlnsPrefixAttributeReference Documentation: XmlnsPrefixAttribute

Argomenti:Arguments:

  • Stringa che specifica l'identificatore di uno spazio dei nomi XAML.A string that specifies the identifier of a XAML namespace.

  • Stringa che specifica un prefisso consigliato.A string that specifies a recommended prefix.

XmlnsDefinitionAttribute Specifica un prefisso consigliato da usare per uno spazio dei nomi XAML.XmlnsDefinitionAttribute specifies a recommended prefix to use for a XAML namespace. Il prefisso è utile quando si scrivono elementi e attributi in un file XAML che viene serializzato da servizi XAML di .NET Framework XamlXmlWriter, o quando una libreria di implementazione XAML interagisce con un ambiente di progettazione XAML con funzionalità di modifica.The prefix is useful when writing elements and attributes in a XAML file that is serialized by the .NET Framework XAML Services XamlXmlWriter, or when a XAML-implementing library interacts with a design environment that has XAML editing features.

Più XmlnsPrefixAttribute può essere applicato a un assembly.More than one XmlnsPrefixAttribute can be applied to an assembly. Questa operazione può essere eseguita per qualsiasi combinazione dei seguenti motivi:This might be done for any combination of the following reasons:

  • L'assembly definisce i tipi per più di uno spazio dei nomi XAML.Your assembly defines types for more than one XAML namespace. In questo caso è necessario definire i valori di prefisso diverso per ogni spazio dei nomi XAML.In this case you should define different prefix values for each XAML namespace.

  • Supporto di più vocabolari e si utilizzano prefissi diversi per ogni vocabolario e spazio dei nomi XAML.You are supporting multiple vocabularies, and you use different prefixes for each vocabulary and XAML namespace.

  • Si definisce il supporto del linguaggio XAML nell'assembly e avere un XmlnsDefinitionAttribute per http://schemas.microsoft.com/winfx/2006/xaml.You define XAML language support in the assembly and have a XmlnsDefinitionAttribute for http://schemas.microsoft.com/winfx/2006/xaml. In questo caso, è in genere opportuno alzare di livello il prefisso x.In this case, you typically should promote the prefix x.

Nota

Servizi XAML di .NET framework definisce anche l'attributo correlati a XAML RootNamespaceAttribute..NET Framework XAML Services also defines the XAML-related attribute RootNamespaceAttribute. Questo attributo è un attributo a livello di assembly per il supporto di sistema di progetto e quindi non è rilevante per i tipi XAML personalizzati.This attribute is an assembly-level attribute for project system support, and it is not relevant for XAML custom types.

Vedere ancheSee Also

Attribute
Definizione di tipi personalizzati da utilizzare con i servizi XAML di .NET FrameworkDefining Custom Types for Use with .NET Framework XAML Services