PreserveSigAttribute Classe

Définition

Espace de noms:

System.Runtime.InteropServices

Assembly:

System.Runtime.InteropServices.dll

Source:

PreserveSigAttribute.cs

Indique que la transformation de signature HRESULT qui a lieu pendant les appels d’interopérabilité COM doit être supprimée.

public ref class PreserveSigAttribute sealed : Attribute

[System.AttributeUsage(System.AttributeTargets.Method, Inherited=false)]
public sealed class PreserveSigAttribute : Attribute

[<System.AttributeUsage(System.AttributeTargets.Method, Inherited=false)>]
type PreserveSigAttribute = class
    inherit Attribute

Public NotInheritable Class PreserveSigAttribute
Inherits Attribute

Héritage

Object

Attribute

PreserveSigAttribute

Attributs

AttributeUsageAttribute

Exemples

L’exemple suivant montre comment Tlbexp.exe convertit une méthode C# sans PreserveSigAttribute lors de l’exportation d’un assembly vers une bibliothèque de type COM.

Signature managée :

int DoSomething (long l);  

Signature non managée :

HRESULT DoSomething ([in] long l, [out, retval] int * i);  

Lorsque vous appliquez PreserveSigAttribute à la même méthode C# et exportez l’assembly, la conversion de méthode diffère de l’exemple précédent. Notez que Tlbexp.exe supprime le modificateur de paramètre HRESULT et le modificateur de paramètre [out, retval].

Signature managée :

[PreserveSig] int DoSomething (long l);  

Signature non managée :

int DoSomething ([in] long l);  

Remarques

Vous pouvez appliquer cet attribut aux méthodes.

Par défaut, le Tlbexp.exe (exportateur de bibliothèque de types) garantit qu’un appel qui retourne un HRESULT de S_OK est transformé de telle sorte que le paramètre [out, retval] soit utilisé comme valeur de retour de fonction. Le S_OK HRESULT est ignoré. Pour les HRESULT autres que S_OK, le runtime lève une exception et ignore le paramètre [out, retval]. Lorsque vous appliquez le PreserveSigAttribute à une signature de méthode managée, les signatures managées et non managées de la méthode attributée sont identiques.

La conservation de la signature de méthode d’origine est nécessaire si le membre retourne plusieurs valeurs HRESULT de réussite et que vous souhaitez détecter les différentes valeurs. Étant donné que la plupart des membres COM retournent un HRESULT, en appliquant , PreserveSigAttributevous pouvez récupérer un entier représentant la réussite ou l’échec HRESULT. Tlbexp.exe conserve tous les paramètres [out, retval] en tant que paramètres out dans la signature managée.

Le Tlbimp.exe (importateur de bibliothèque de types) applique également cet attribut ; il applique l’attribut à dispinterfaces lorsqu’il importe une bibliothèque de types.

Notes

Les types de retour de Currency, Guidet Object ne sont pas pris en charge par la classe lorsque l’interopérabilité PreserveSigAttribute se produit de COM vers le code managé et que le code managé est marqué avec la PreserveSigAttribute classe . Lorsque vous tentez d’utiliser l’un de ces types de retour avec la PreserveSigAttribute classe pendant ces conditions, un TypeLoadException est levée.

Constructeurs

PreserveSigAttribute()

Initialise une nouvelle instance de la classe PreserveSigAttribute.

Propriétés

TypeId

Lors de l'implémentation dans une classe dérivée, obtient un identificateur unique pour l'objet Attribute. (Hérité de Attribute)

Méthodes

Equals(Object)	Retourne une valeur qui indique si cette instance est égale à un objet spécifié. (Hérité de Attribute)
GetHashCode()	Retourne le code de hachage de cette instance. (Hérité de Attribute)
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
IsDefaultAttribute()	En cas de substitution dans une classe dérivée, indique si la valeur de cette instance est la valeur par défaut pour la classe dérivée. (Hérité de Attribute)
Match(Object)	En cas de substitution dans une classe dérivée, retourne une valeur indiquant si cette instance équivaut à un objet spécifié. (Hérité de Attribute)
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
ToString()	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object)

Voir aussi

• Tlbexp.exe (exportateur de bibliothèques de types)
• Tlbimp.exe (Type Library Importer)