PostSharp 2023.0 / / Post­Sharp Documentation / API Reference / Post­Sharp.​Patterns.​Contracts Namespace / Location­Contract­Attribute Class

LocationContractAttribute Class
Base class for other custom attributes in this namespace.
Inheritance Hierarchy
System.Object
  System.Attribute
    PostSharp.Extensibility.MulticastAttribute
      PostSharp.Patterns.Contracts.LocationContractAttribute
        More...

Namespace:  PostSharp.Patterns.Contracts
Assembly:  PostSharp.Patterns.Common (in PostSharp.Patterns.Common.dll) Version: 2023.0.3.0 (2023.0.3.0)
Syntax
C#
Copy
public abstract class LocationContractAttribute : MulticastAttribute, 
	ILocationLevelAspect, IAspect

The LocationContractAttribute type exposes the following members.

Constructors
  NameDescription
Protected methodLocationContractAttribute
Initializes a new LocationContractAttribute.
Properties
  NameDescription
Public propertyAttributeExclude
If true, indicates that this attribute removes all other instances of the same attribute type from the set of elements defined by the current instance.
(Inherited from MulticastAttribute.)
Public propertyAttributeInheritance
Determines whether this attribute is inherited
(Inherited from MulticastAttribute.)
Public propertyAttributePriority
Gets or sets the priority of the current attribute in case that multiple instances are defined on the same element (lower values are processed before).
(Inherited from MulticastAttribute.)
Public propertyAttributeReplace
Determines whether this attribute replaces other attributes found on the target declarations.
(Inherited from MulticastAttribute.)
Public propertyAttributeTargetAssemblies
Gets or sets the assemblies to which the current attribute apply.
(Inherited from MulticastAttribute.)
Public propertyAttributeTargetElements
Gets or sets the kind of elements to which this custom attributes applies.
(Inherited from MulticastAttribute.)
Public propertyAttributeTargetExternalMemberAttributes
Gets or sets the visibilities, scopes, virtualities, and implementation of members to which this attribute applies, when the member is external to the current module.
(Inherited from MulticastAttribute.)
Public propertyAttributeTargetExternalTypeAttributes
Gets or sets the visibilities of types to which this attribute applies, when this type is external to the current module.
(Inherited from MulticastAttribute.)
Public propertyAttributeTargetMemberAttributes
Gets or sets the visibilities, scopes, virtualities, and other characteristics of members to which this attribute applies.
(Inherited from MulticastAttribute.)
Public propertyAttributeTargetMembers
Gets or sets the expression specifying to which members this instance applies.
(Inherited from MulticastAttribute.)
Public propertyAttributeTargetParameterAttributes
Gets or sets the passing style (by value, out or ref) of parameters to which this attribute applies.
(Inherited from MulticastAttribute.)
Public propertyAttributeTargetParameters
Gets or sets the expression specifying to which parameters this instance applies.
(Inherited from MulticastAttribute.)
Public propertyAttributeTargetTypeAttributes
Gets or sets the attributes of types to which this attribute applies. Visibility, scope (Instance or Static) and generation are the only categories that are taken into account; attributes of other categories are ignored.
(Inherited from MulticastAttribute.)
Public propertyAttributeTargetTypes
Gets or sets the expression specifying to which types this instance applies.
(Inherited from MulticastAttribute.)
Public propertyErrorMessage Obsolete.
Gets or sets the error message formatting string.
Methods
  NameDescription
Protected methodCompileTimeValidate
Validates that the current aspect has been applied to a valid location.
Protected methodCreateArgumentException Obsolete.
Creates an ArgumentException with an error message formatted from ErrorMessage and given concrete values.
Protected methodCreateArgumentNullException Obsolete.
Creates an ArgumentNullException with an error message formatted from ErrorMessage and given concrete values.
Protected methodCreateArgumentOutOfRangeException Obsolete.
Creates an ArgumentOutOfRangeException with an error message formatted from ErrorMessage and given concrete values.
Protected methodCreatePostconditionFailedException Obsolete.
Creates an PostconditionFailedException with an error message formatted from ErrorMessage and given concrete values.
Protected methodFormatErrorMessage Obsolete.
Formats the ErrorMessage with concrete values.
Protected methodGetErrorMessage Obsolete.
Gets unformatted error message as defined by the instance.
Protected methodGetErrorMessageArguments Obsolete.
Gets values of additional arguments for error message associated with particular instance of LocationContractAttribute. There arguments can be referenced from error message string by {4}, {5} and so on.
Public methodRuntimeInitialize
Initializes the aspect at runtime.
Protected methodSelectSelfOrNothing
A pointcut that selects the target location of the current aspect, unless the target location is a dependency property or an attached property.
Public methodValidateValueDynamic
Validates a weakly-typed (boxed) value, typically the value of a dependency property or an attached property.
Remarks

Basic error message is identified by LocationContractErrorMessage and obtained from the provider set in LocalizedTextProvider.

All formatting strings have the following parameters replaced:

  • {0} is replaced by the location name.
  • {1} is replaced by the location kind.
  • {2} is replaced by a string containing both location kind and name.
  • {3} is replaced by the value which caused the error when being assigned to the location.
  • Further parameters are described in the remarks sections of contracts which override the GetErrorMessageArguments() method.

Note that an array of error message arguments is cached for each location.

See Also
Inheritance Hierarchy