Classe ExperimentalAttribute

Indica que uma API é experimental e pode mudar no futuro.

Herança

objeto

Atributo

Atributo experimental

Namespace: System.Diagnósticos.CodeAnalysis

Conjunto: Realm.exe

Sintaxe

[AttributeUsage(AttributeTargets.Assembly|AttributeTargets.Module|AttributeTargets.Class|AttributeTargets.Struct|AttributeTargets.Enum|AttributeTargets.Constructor|AttributeTargets.Method|AttributeTargets.Property|AttributeTargets.Field|AttributeTargets.Event|AttributeTargets.Interface|AttributeTargets.Delegate, Inherited = false)]
public sealed class ExperimentalAttribute : Attribute

Observações

Esse atributo permite que os locais de chamada sejam sinalizados com um diagnóstico que indica que um recurso experimental está sendo usado. Os autores podem usar este atributo para enviar recursos de visualização em suas montagens.
Este é um polyfill do ExperimentalAttribute adicionado no .NET 8.

Construtores

ExperimentalAttribute(string)

Inicializa uma nova instância da classe ExperimentalAttribute , especificando o ID que o compilador usará ao relatar um uso da API à qual o atributo se aplica.

Declaração

public ExperimentalAttribute(string diagnosticId)

Parâmetros

Tipo	Nome	Descrição
string	diagnósticaId	O ID que o compilador usará ao relatar o uso da API à qual o atributo se aplica.

Propriedades

DiagnosticId

Obtém o ID que o compilador usará ao relatar um uso da API à qual o atributo se aplica.

Declaração

public string DiagnosticId { get; }

Valor da propriedade

Tipo	Descrição
string	A ID de diagnóstico exclusiva.

Observações

O ID de diagnóstico é mostrado na saída de compilação para avisos e erros.

Essa propriedade representa o ID exclusivo que pode ser usado para suprimir os avisos ou erros, se necessário.

URLFormat

Obtém ou define a URL para a documentação correspondente.

A API aceita uma string de formato em vez de uma URL real , criando uma URL genérica que inclui a ID de diagnóstico.

Declaração

public string? UrlFormat { get; set; }

Valor da propriedade

Tipo	Descrição
string	A string de formato que representa um URL para a documentação correspondente.

Observações

Um exemplo de string de formato é https://contoso.com/obsoletion-warnings/{0}.