PreserveSigAttribute Класс

Определение

Пространство имен:

System.Runtime.InteropServices

Сборка:

System.Runtime.InteropServices.dll

Исходный код:

PreserveSigAttribute.cs

Указывает, что преобразование сигнатуры HRESULT, которое выполняется во время вызовов COM-взаимодействия, должно быть подавлено.

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

Наследование

Object

Attribute

PreserveSigAttribute

Атрибуты

AttributeUsageAttribute

Примеры

В следующем примере показано, как Tlbexp.exe преобразует метод C# без PreserveSigAttribute при экспорте сборки в библиотеку типов COM.

Управляемая сигнатура:

int DoSomething (long l);  

Неуправляемая подпись:

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

При применении PreserveSigAttribute к одному и тому же методу C# и экспорте сборки преобразование метода отличается от предыдущего примера. Обратите внимание, что Tlbexp.exe удаляет модификатор параметров HRESULT и [out, retval].

Управляемая сигнатура:

[PreserveSig] int DoSomething (long l);  

Неуправляемая подпись:

int DoSomething ([in] long l);  

Комментарии

Этот атрибут можно применить к методам.

По умолчанию Tlbexp.exe (средство экспорта библиотек типов) гарантирует, что вызов, возвращающий HRESULT S_OK, преобразуется таким образом, что в качестве возвращаемого значения функции используется параметр [out, retval]. Отбрасывается S_OK HRESULT. Для HRESULT, отличных от S_OK, среда выполнения создает исключение и отменяет параметр [out, retval]. При применении к сигнатуре PreserveSigAttribute управляемого метода управляемые и неуправляемые сигнатуры метода с атрибутами идентичны.

Сохранение исходной сигнатуры метода необходимо, если элемент возвращает несколько значений HRESULT успешного выполнения и требуется обнаружить различные значения. Так как большинство com-членов возвращают HRESULT, применив PreserveSigAttribute, можно получить целое число, представляющее успешное или неудачное HRESULT. Tlbexp.exe сохраняет все параметры [out, retval] в качестве параметров out в управляемой сигнатуре.

Этот атрибут также применяется вTlbimp.exe (средство импорта библиотек типов); он применяет атрибут к dispinterfaces при импорте библиотеки типов.

Примечание

Типы возвращаемых значений , и не поддерживаются классом PreserveSigAttribute , если происходит взаимодействие из COM в управляемый код и управляемый код помечен классом PreserveSigAttribute .ObjectGuidCurrency При попытке использовать один из этих типов возвращаемых значений с классом PreserveSigAttribute во время выполнения этих условий TypeLoadException возникает исключение .

Конструкторы

PreserveSigAttribute()

Инициализирует новый экземпляр класса PreserveSigAttribute.

Свойства

TypeId

В случае реализации в производном классе возвращает уникальный идентификатор для этого атрибута Attribute. (Унаследовано от Attribute)

Методы

Equals(Object)	Возвращает значение, показывающее, равен ли экземпляр указанному объекту. (Унаследовано от Attribute)
GetHashCode()	Возвращает хэш-код данного экземпляра. (Унаследовано от Attribute)
GetType()	Возвращает объект Type для текущего экземпляра. (Унаследовано от Object)
IsDefaultAttribute()	При переопределении в производном классе указывает, является ли значение этого экземпляра значением по умолчанию для производного класса. (Унаследовано от Attribute)
Match(Object)	При переопределении в производном классе возвращает значение, указывающее, является ли этот экземпляр равным заданному объекту. (Унаследовано от Attribute)
MemberwiseClone()	Создает неполную копию текущего объекта Object. (Унаследовано от Object)
ToString()	Возвращает строку, представляющую текущий объект. (Унаследовано от Object)

См. также раздел

• Tlbexp.exe (программа экспорта библиотек типов)
• Tlbimp.exe (программа экспорта библиотек типов)