Exportar (0) Imprimir
Expandir todo
Este artículo proviene de un motor de traducción automática. Mueva el puntero sobre las frases del artículo para ver el texto original. Más información.
Traducción
Original

ObsoleteAttribute (Clase)

Marca los elementos del programa que ya no se utilizan. Esta clase no puede heredarse.

System.Object
  System.Attribute
    System.ObsoleteAttribute

Espacio de nombres:  System
Ensamblado:  mscorlib (en mscorlib.dll)

[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

El tipo ObsoleteAttribute expone los siguientes miembros.

  NombreDescripción
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsObsoleteAttribute()Inicializa una nueva instancia de la clase ObsoleteAttribute con propiedades predeterminadas.
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsObsoleteAttribute(String)Inicializa una nueva instancia de la clase ObsoleteAttribute con el mensaje de solución especificado.
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsObsoleteAttribute(String, Boolean)Inicializa una nueva instancia de la clase ObsoleteAttribute con un mensaje de solución y un valor Boolean que indica si el uso del elemento obsoleto se considera un error.
Arriba

  NombreDescripción
Propiedad públicaCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsIsErrorObtiene un valor Boolean que indica si el compilador tratará el uso del elemento de programa obsoleto como un error.
Propiedad públicaCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsMessageObtiene el mensaje de solución en el que se incluye una descripción de los elementos de programa alternativos.
Propiedad públicaTypeIdCuando se implementa en una clase derivada, obtiene un identificador único para este Attribute. (Se hereda de Attribute).
Arriba

  NombreDescripción
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsEqualsInfraestructura. Devuelve un valor que indica si esta instancia equivale al objeto especificado. (Se hereda de Attribute).
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsGetHashCodeDevuelve el código hash de esta instancia. (Se hereda de Attribute).
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsGetType Obtiene el Type de la instancia actual. (Se hereda de Object).
Método públicoIsDefaultAttributeCuando se invalida en una clase derivada, indica si el valor de esta instancia es el valor predeterminado para la clase derivada. (Se hereda de Attribute).
Método públicoCompatible con XNA FrameworkMatch Cuando se invalida en una clase derivada, devuelve un valor que indica si esta instancia es igual al objeto especificado. (Se hereda de Attribute).
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsToString Retorna una cadena que representa al objeto actual. (Se hereda de Object).
Arriba

  NombreDescripción
Implementación explícita de interfacesMétodo privado_Attribute.GetIDsOfNamesAsigna un conjunto de nombres a un conjunto correspondiente de identificadores de envío. (Se hereda de Attribute).
Implementación explícita de interfacesMétodo privado_Attribute.GetTypeInfoObtiene la información de tipos de un objeto, que puede utilizarse para obtener la información de tipos de una interfaz. (Se hereda de Attribute).
Implementación explícita de interfacesMétodo privado_Attribute.GetTypeInfoCount

Recupera el número de interfaces de tipo de información que suministra un objeto (0 ó 1)

(Se hereda de Attribute).
Implementación explícita de interfacesMétodo privado_Attribute.InvokeProporciona acceso a las propiedades y los métodos expuestos por un objeto. (Se hereda de Attribute).
Arriba

ObsoleteAttribute es aplicable a todos los elementos de programa excepto los ensamblados, módulos, los parámetros, y los valores devueltos. Marcar un elemento como obsoletos informa a usuarios que el elemento se quitará en futuras versiones del producto.

La clase de ObsoleteAttribute incluye dos propiedades:

  • Message . La cadena asignada a la propiedad de Message es emitido por el compilador cuando el destino de atributo se utiliza en el código. La cadena debe tener en cuenta que el destino de atributo está obsoleto y, si es posible, proporciona cierta solución alternativa o alternativa de programación.

  • IsError . Éste es un valor booleano que indica al compilador si utilizar el atributo de ObsoleteAttribute debe hacer para emitir un error (IsError es true) o una advertencia (IsError es false).

Para obtener más información sobre cómo utilizar los atributos, vea Extender metadatos mediante atributos.

Aplicaciones de Tienda Windows

Cuando se crea una biblioteca de metadatos de Windows (archivo de .winmd), ObsoleteAttribute se exporta como el atributo de ObsoleteAttribute y Windows.Foundation.Metadata.DeprecatedAttribute el atributo si sólo ObsoleteAttribute está presente en código fuente. ObsoleteAttribute se transforma en DeprecatedAttribute como sigue:

  • Si los argumentos de message y de error son ambos presente, message se asigna al argumento de DeprecatedAttributemessage . Un valor de error de mapas de true a DeprecationType.Remove, y un valor de error de mapas de false a DeprecationType.Deprecate.

  • Si el argumento de message no aparecerá en ObsoleteAttribute, su valor predeterminado en DeprecatedAttribute es “element_name está desusada”, donde es el nombre element_name de elementos de programa de destino al que se aplica el atributo.

  • Si el argumento de error no está presente en ObsoleteAttribute, su valor predeterminado en DeprecatedAttribute es DeprecationType.Deprecate.

Nota importanteImportante

Directamente al aplicar Windows.Foundation.Metadata.DeprecatedAttribute el atributo al código administrado no se recomienda, porque esta exportación aparece automáticamente.

El ejemplo siguiente define una clase que contiene una propiedad y un método marcadas con el atributo de ObsoleteAttribute . El acceso al valor de propiedad de OldProperty en código genera una advertencia del compilador, pero llamar al método de CallOldMethod genera un error del compilador. El ejemplo también se muestra el resultado de esa resultados cuando se intenta compilar el código fuente.


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.'


.NET Framework

Compatible con: 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Compatible con: 4, 3.5 SP1

Biblioteca de clases portable

Compatible con: Biblioteca de clases portable

.NET para aplicaciones de la Tienda Windows

Compatible con: Windows 8

.NET para aplicaciones de Windows Phone

Compatible con: Windows Phone 8, Silverlight 8.1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (no se admite el rol Server Core), Windows Server 2008 R2 (se admite el rol Server Core con SP1 o versiones posteriores; no se admite Itanium)

.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

Todos los miembros static (Shared en Visual Basic) públicos de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancias sean seguros para la ejecución de subprocesos.

Adiciones de comunidad

AGREGAR
Mostrar:
© 2014 Microsoft