Questo articolo è stato tradotto automaticamente. Per visualizzare l'articolo in inglese, selezionare la casella di controllo Inglese. È possibile anche visualizzare il testo inglese in una finestra popup posizionando il puntatore del mouse sopra il testo.
Traduzione
Inglese

Classe ObsoleteAttribute

 

Data di pubblicazione: ottobre 2016

Contrassegna gli elementi del programma che non sono più in uso. Questa classe non può essere ereditata.

Spazio dei nomi:   System
Assembly:  mscorlib (in mscorlib.dll)

System.Object
  System.Attribute
    System.ObsoleteAttribute

[SerializableAttribute]
[AttributeUsageAttribute(AttributeTargets.Class | AttributeTargets.Struct | AttributeTargets.Enum | AttributeTargets.Constructor | AttributeTargets.Method | AttributeTargets.Property | AttributeTargets.Field | AttributeTargets.Event | AttributeTargets.Interface | AttributeTargets.Delegate, 
	Inherited = false)]
[ComVisibleAttribute(true)]
public sealed class ObsoleteAttribute : Attribute

NomeDescrizione
System_CAPS_pubmethodObsoleteAttribute()

Inizializza una nuova istanza della classe ObsoleteAttribute con le proprietà predefinite.

System_CAPS_pubmethodObsoleteAttribute(String)

Inizializza una nuova istanza di ObsoleteAttribute classe con un messaggio alternativo specificato.

System_CAPS_pubmethodObsoleteAttribute(String, Boolean)

Inizializza una nuova istanza di ObsoleteAttribute classe con un messaggio alternativo e un valore booleano che indica se l'utilizzo dell'elemento obsoleto viene considerato un errore.

NomeDescrizione
System_CAPS_pubpropertyIsError

Ottiene un valore booleano che indica se il compilatore considererà l'utilizzo dell'elemento del programma obsoleto come errore.

System_CAPS_pubpropertyMessage

Ottiene il messaggio alternativo, inclusa una descrizione degli elementi di programma alternativo.

System_CAPS_pubpropertyTypeId

Quando è implementata in una classe derivata, ottiene un identificatore univoco della classe Attribute.(Ereditato da Attribute.)

NomeDescrizione
System_CAPS_pubmethodEquals(Object)

Questa API supporta l'infrastruttura prodotto e non può essere usata direttamente dal codice. Restituisce un valore che indica se questa istanza è uguale ad un oggetto specificato. (Ereditato da Attribute.)

System_CAPS_pubmethodGetHashCode()

Restituisce il codice hash per questa istanza. (Ereditato da Attribute.)

System_CAPS_pubmethodGetType()

Ottiene l'oggetto Type dell'istanza corrente.(Ereditato da Object.)

System_CAPS_pubmethodIsDefaultAttribute()

Quando viene eseguito l'override in una classe derivata, indica se il valore di questa istanza è il valore predefinito per la classe derivata. (Ereditato da Attribute.)

System_CAPS_pubmethodMatch(Object)

Quando viene eseguito l'override in una classe derivata, restituisce un valore che indica se questa istanza equivale a un oggetto specificato. (Ereditato da Attribute.)

System_CAPS_pubmethodToString()

Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object.)

NomeDescrizione
System_CAPS_pubinterfaceSystem_CAPS_privmethod_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)

Esegue il mapping di un set di nomi a un corrispondente set di identificatori di dispatch. (Ereditato da Attribute.)

System_CAPS_pubinterfaceSystem_CAPS_privmethod_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)

Recupera le informazioni sui tipi per un oggetto, che possono essere utilizzate per ottenere informazioni sul tipo per un'interfaccia. (Ereditato da Attribute.)

System_CAPS_pubinterfaceSystem_CAPS_privmethod_Attribute.GetTypeInfoCount(UInt32)

Recupera il numero di interfacce di informazioni sui tipi che un oggetto fornisce (0 o 1). (Ereditato da Attribute.)

System_CAPS_pubinterfaceSystem_CAPS_privmethod_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

Fornisce l'accesso alle proprietà ed ai metodi esposti da un oggetto. (Ereditato da Attribute.)

ObsoleteAttribute è applicabile a tutti gli elementi di programma, ad eccezione degli assembly, moduli, parametri e valori restituiti. Contrassegno di un elemento come obsoleto informa gli utenti che l'elemento sarà rimosso nelle versioni future del prodotto.

La ObsoleteAttribute classe include due proprietà:

  • Message. La stringa assegnata alla Message proprietà viene generata dal compilatore quando la destinazione dell'attributo è utilizzata nel codice. La stringa deve tenere presente che la destinazione dell'attributo è obsoleta e, se possibile, fornire alcune soluzioni alternative o alternativa a livello di codice.

  • IsError. Si tratta di un valore booleano che indica al compilatore che specifica se tramite il ObsoleteAttribute attributo dovrebbe impedirne di generare un errore (IsError è true) o un avviso (IsError è false).

Per ulteriori informazioni sull'utilizzo degli attributi, vedere Estensione di metadati mediante attributi.

Quando si crea una raccolta di metadati Windows (file con estensione winmd), il ObsoleteAttribute viene esportato sia come il ObsoleteAttribute attributo e il Windows.Foundation.Metadata.DeprecatedAttribute attributo se solo il ObsoleteAttribute è presente nel codice sorgente. Il ObsoleteAttribute viene trasformato il DeprecatedAttribute come indicato di seguito:

  • Se il message e error gli argomenti sono entrambi presenti, message è assegnata la DeprecatedAttributemessage argomento. Il valore di errore true esegue il mapping a DeprecationType.Remove, e un error valore false esegue il mapping a DeprecationType.Deprecate.

  • Se il message argomento non viene fornito nel ObsoleteAttribute, il valore predefinito nel DeprecatedAttribute è "nome_elemento è deprecata", dove nome_elemento è il nome dell'elemento di programma di destinazione a cui è applicato l'attributo.

  • Se il error argomento non è presente nel ObsoleteAttribute, il valore predefinito nel DeprecatedAttribute è DeprecationType.Deprecate.

System_CAPS_importantImportante

L'applicazione direttamente il Windows.Foundation.Metadata.DeprecatedAttribute attributo al codice gestito non è consigliabile, perché questa esportazione viene eseguita automaticamente.

Nell'esempio seguente viene definita una classe che contiene una proprietà e un metodo contrassegnato con il ObsoleteAttribute attributo. L'accesso al valore della OldProperty proprietà nel codice genera un compilatore di avviso, ma la chiamata di CallOldMethod metodo genera un errore del compilatore. Nell'esempio viene inoltre illustrato l'output risultante quando si tenta di compilare il codice sorgente.

using System;
using System.Reflection;

public class Example
{
   // Mark OldProperty As Obsolete.
   [ObsoleteAttribute("This property is obsolete. Use NewProperty instead.", false)] 
   public static string OldProperty
   { get { return "The old property value."; } }

   public static string NewProperty
   { get { return "The new property value."; } }

   // Mark CallOldMethod As Obsolete.
   [ObsoleteAttribute("This method is obsolete. Call CallNewMethod instead.", true)] 
   public static string CallOldMethod()
   {
      return "You have called CallOldMethod.";
   }

   public static string CallNewMethod() 
   {   
      return "You have called CallNewMethod.";
   }   

   public static void Main()
   {                 
      Console.WriteLine(OldProperty);
      Console.WriteLine();
      Console.WriteLine(CallOldMethod());
   } 
}
// The attempt to compile this example produces output like the following output:
//    Example.cs(31,25): error CS0619: 'Example.CallOldMethod()' is obsolete: 
//            'This method is obsolete. Call CallNewMethod instead.'
//    Example.cs(29,25): warning CS0618: 'Example.OldProperty' is obsolete: 
//            'This property is obsolete. Use NewProperty instead.'

Universal Windows Platform
Disponibile da 8
.NET Framework
Disponibile da 1.1
Libreria di classi portabile
Supportato in: piattaforme .NET portabili
Silverlight
Disponibile da 2.0
Windows Phone Silverlight
Disponibile da 7.0
Windows Phone
Disponibile da 8.1

I membri statici pubblici ( Condiviso in Visual Basic) di questo tipo è thread safe. Non tutti i membri di istanza sono garantiti come thread safe.

Torna all'inizio
Mostra: