Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

Clase RuntimeCompatibilityAttribute

 

Publicado: octubre de 2016

Especifica si se deben ajustar las excepciones que no derivan de la Exception clase con un RuntimeWrappedException objeto. Esta clase no puede heredarse.

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

System.Object
  System.Attribute
    System.Runtime.CompilerServices.RuntimeCompatibilityAttribute

[SerializableAttribute]
[AttributeUsageAttribute(AttributeTargets.Assembly, Inherited = false, 
	AllowMultiple = false)]
public sealed class RuntimeCompatibilityAttribute : Attribute

NombreDescripción
System_CAPS_pubmethodRuntimeCompatibilityAttribute()

Inicializa una nueva instancia de la clase RuntimeCompatibilityAttribute.

NombreDescripción
System_CAPS_pubpropertyTypeId

Cuando se implementa en una clase derivada, obtiene un identificador único para este Attribute.(Heredado de Attribute).

System_CAPS_pubpropertyWrapNonExceptionThrows

Obtiene o establece un valor que indica si se ajustan las excepciones que no derivan de la Exception clase con un RuntimeWrappedException objeto.

NombreDescripción
System_CAPS_pubmethodEquals(Object)

Esta API admite la infraestructura producto y no está diseñada para usarse directamente desde el código. Devuelve un valor que indica si esta instancia equivale al objeto especificado. (Heredado de Attribute).

System_CAPS_pubmethodGetHashCode()

Devuelve el código hash de esta instancia.(Heredado de Attribute).

System_CAPS_pubmethodGetType()

Obtiene el Type de la instancia actual.(Heredado de Object).

System_CAPS_pubmethodIsDefaultAttribute()

Si se reemplaza en una clase derivada, indica si el valor de esta instancia es el valor predeterminado de la clase derivada.(Heredado de Attribute).

System_CAPS_pubmethodMatch(Object)

Cuando se invalida en una clase derivada, devuelve un valor que indica si esta instancia es igual al objeto especificado. (Heredado de Attribute).

System_CAPS_pubmethodToString()

Devuelve una cadena que representa al objeto actual. (Heredado de Object).

NombreDescripción
System_CAPS_pubinterfaceSystem_CAPS_privmethod_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)

Asigna un conjunto de nombres a un conjunto correspondiente de identificadores de envío.(Heredado de Attribute).

System_CAPS_pubinterfaceSystem_CAPS_privmethod_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)

Obtiene la información del tipo de un objeto, que puede utilizarse para obtener la información del tipo de una interfaz. (Heredado de Attribute).

System_CAPS_pubinterfaceSystem_CAPS_privmethod_Attribute.GetTypeInfoCount(UInt32)

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

(Heredado de Attribute).

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

Proporciona acceso a las propiedades y los métodos expuestos por un objeto.(Heredado de Attribute).

Algunos lenguajes, como C++, permiten iniciar excepciones de cualquier tipo. Otros lenguajes, como Microsoft C# y Visual Basic, requieren que cada excepción se deriva la Exception clase. Para mantener la compatibilidad entre idiomas, common language runtime (CLR) ajusta los objetos que no derivan de Exception en un RuntimeWrappedException objeto.

Puede usar el RuntimeCompatibilityAttribute clase para especificar si las excepciones deben aparecer ajustadas dentro de bloques catch y filtros de excepción para un ensamblado. Muchos de los compiladores de lenguaje, incluidos los compiladores de Microsoft C# y Visual Basic, aplican este atributo para especificar el comportamiento de ajuste de forma predeterminada.

Tenga en cuenta que el tiempo de ejecución sigue ajusta las excepciones, incluso si utiliza la RuntimeCompatibilityAttribute clase para especificar que no desea ajustada. En este caso, las excepciones se desajustan dentro de bloques catch o filtros de excepciones.

En el ejemplo de código siguiente se muestra cómo aplicar el RuntimeCompatibilityAttribute clase a un ensamblado que inicia un String objeto como una excepción de C++ y la captura mediante un RuntimeWrappedException objeto.

using namespace System;
using namespace System::Runtime::CompilerServices;

[assembly:RuntimeCompatibilityAttribute(WrapNonExceptionThrows = true)]; 

void run()
{
    try
    {
        throw gcnew String("This is a string");

    }
    catch(RuntimeWrappedException^ e)
    {
        Console::WriteLine("RuntimeWrappedException caught!");
    }
}

int main()
{
    run();

    return 0;
}

Plataforma universal de Windows
Disponible desde 8
.NET Framework
Disponible desde 2.0
Biblioteca de clases portable
Se admite en: plataformas portátiles de .NET
Silverlight
Disponible desde 2.0
Windows Phone Silverlight
Disponible desde 7.0
Windows Phone
Disponible desde 8.1

Cualquier miembro ( Compartido en Visual Basic) estático público de este tipo es seguro para subprocesos. No se garantiza que los miembros de instancia sean seguros para subprocesos.

Volver al principio
Mostrar: