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 ContractOptionAttribute

.NET Framework (current version)
 

Publicado: octubre de 2016

Permite establecer las opciones de contrato y la herramienta en la granularidad de ensamblado, tipo o método.

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

System.Object
  System.Attribute
    System.Diagnostics.Contracts.ContractOptionAttribute

[AttributeUsageAttribute(AttributeTargets.All, AllowMultiple = true, 
	Inherited = false)]
[ConditionalAttribute("CONTRACTS_FULL")]
public sealed class ContractOptionAttribute : Attribute

NombreDescripción
System_CAPS_pubmethodContractOptionAttribute(String, String, Boolean)

Inicializa una nueva instancia de la ContractOptionAttribute clase mediante el uso de la categoría proporcionada, la configuración y el valor de habilitar o deshabilitar.

System_CAPS_pubmethodContractOptionAttribute(String, String, String)

Inicializa una nueva instancia de la ContractOptionAttribute clase mediante el uso de la categoría proporcionada, configuración y el valor.

NombreDescripción
System_CAPS_pubpropertyCategory

Obtiene la categoría de la opción.

System_CAPS_pubpropertyEnabled

Determina si una opción está habilitada.

System_CAPS_pubpropertySetting

Obtiene el valor de la opción.

System_CAPS_pubpropertyTypeId

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

System_CAPS_pubpropertyValue

Obtiene el valor de la opción.

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

La tabla siguiente muestran las opciones admitidas actualmente.

Categoría

Parámetro

Valor/efecto

contrato

herencia

true Para activar la herencia del contrato; false para desactivarlo. De manera predeterminada, es true.

motor en tiempo de ejecución

comprobar

true Para desactivar la comprobación de tiempo de ejecución. false para desactivarlo. De manera predeterminada, es true.

Puede utilizar este atributo, como se muestra en los ejemplos siguientes.

Para desactivar la comprobación de todo el ensamblado de tiempo de ejecución:

[assembly:ContractOption("runtime", "checking", false)]

Para activar la comprobación de contrato de tiempo de ejecución para un tipo específico:

[ContractOption("runtime", "checking", true)]
class TypeWithRuntimeChecking {

    ...

Para desactivar la comprobación en tiempo de ejecución para un método específico:

// Turn off all contract inheritance from interface IList<T>
[ContractOption("contract", "inheritance", false)]
class MyConcurrentList<T> : IList<T> {
   ...
}

[ContractOption("runtime", "checking", false)]
public override MyMethod(int x) {
   // no inherited contracts checked at runtime,
   // no invariants checked at runtime.
   ...
}

       [ContractOption("runtime", "checking", false)]
       public void MethodWithoutRuntimeChecking(...) {
          ...
       }
   }

Plataforma universal de Windows
Disponible desde 8
.NET Framework
Disponible desde 4.5
Biblioteca de clases portable
Se admite en: plataformas portátiles de .NET
Windows Phone Silverlight
Disponible desde 8.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: