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, onde o compilador não permite que o ref escape do método. Por exemplo:

• this por struct exemplo, métodos.
• ref parâmetros que se referem a ref struct tipos.
• 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.

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 RefSafetyRulesAttribute está presente no módulo, pelo que este atributo tem o seu efeito documentado apenas num módulo que também está anotado com RefSafetyRulesAttribute.