UnscopedRefAttribute Classe

Definição

public ref class UnscopedRefAttribute sealed : Attribute

[System.AttributeUsage(System.AttributeTargets.Method | System.AttributeTargets.Parameter | System.AttributeTargets.Property, AllowMultiple=false, Inherited=false)]
public sealed class UnscopedRefAttribute : Attribute

[<System.AttributeUsage(System.AttributeTargets.Method | System.AttributeTargets.Parameter | System.AttributeTargets.Property, AllowMultiple=false, Inherited=false)>]
type UnscopedRefAttribute = class
    inherit Attribute

Public NotInheritable Class UnscopedRefAttribute
Inherits Attribute

Herança

Object

Attribute

UnscopedRefAttribute

Atributos

AttributeUsageAttribute

Observações

Existem vários casos em que o compilador C# trata a ref como implicitamente scoped - em que o compilador não permite que o ref escape do método.

Por exemplo:

1. this por struct exemplo, métodos.
2. ref parâmetros que se referem a ref struct tipos.
3. out parâmetros.

Este atributo é usado nas situações em que o ref deverá ser autorizado a escapar.

Aplicar este atributo, de qualquer forma, afeta os consumidores da API aplicável. É necessário que os autores da API compreendam as implicações ao longo da vida de aplicar este atributo e como pode impactar os seus utilizadores.

<Formato Type="Texto/Markdown">

Esta característica é especialmente reconhecida pelo tempo de execução. O aumento ECMA-335 III.1.7.7 define restrições sobre IL válido que faz referência a este atributo. Por exemplo, quando este atributo é aplicado a um método de instância de um tipo de valor, o this argumento pode escapar ao método. Quando o atributo está ausente, um compilador otimizador pode confiar em this não escapar para otimizar ainda mais certos padrões de código, como eliminar o boxing. Para mais informações, consulte o Adendo da Especificação CLI ECMA-335, Sec. III.1.7.7 ("Restrições de opt-in").

Como o tempo de execução depende deste atributo, não pode ser removido de uma assembleia. As restrições definidas pelo augment III.1.7.7 aplicam-se apenas quando o <atributo> xref:System.Runtime.CompilerServices.RefSafetyRulesEstá presente no módulo, pelo que este atributo tem o seu efeito documentado apenas num módulo que também está anotado com 'RefSafetyRulesAttribute'.

</format>