PreserveSigAttribute クラス

定義

名前空間:

System.Runtime.InteropServices

アセンブリ:

System.Runtime.InteropServices.dll

ソース:

PreserveSigAttribute.cs

COM 相互運用呼び出し中に行われる HRESULT 署名変換を抑制する必要があることを示します。

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、アセンブリを COM タイプ ライブラリにエクスポートせずに PreserveSigAttribute C# メソッドを変換する方法を示しています。

マネージド署名:

int DoSomething (long l);  

アンマネージド シグネチャ:

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

同じ C# メソッドに適用 PreserveSigAttribute してアセンブリをエクスポートすると、メソッド変換は前の例とは異なります。 Tlbexp.exeは、HRESULT パラメーターと [out, retval] パラメーター修飾子を削除します。

マネージド署名:

[PreserveSig] int DoSomething (long l);  

アンマネージド シグネチャ:

int DoSomething ([in] long l);  

注釈

この属性はメソッドに適用できます。

既定では、 Tlbexp.exe (タイプ ライブラリ エクスポーター) を使用すると、S_OKの HRESULT を返す呼び出しが変換され、[out, retval] パラメーターが関数の戻り値として使用されます。 S_OK HRESULT は破棄されます。 S_OK以外の HRESULT の場合、ランタイムは例外をスローし、[out, retval] パラメーターを破棄します。 をマネージド メソッド シグネチャに適用 PreserveSigAttribute すると、属性付きメソッドのマネージド シグネチャとアンマネージド シグネチャは同じです。

メンバーが複数の成功 HRESULT 値を返し、異なる値を検出する場合は、元のメソッド シグネチャを保持する必要があります。 ほとんどの COM メンバーは HRESULT を返すので、 を PreserveSigAttribute適用することで、HRESULT の成功または失敗を表す整数を取得できます。 Tlbexp.exeは、[out, retval] パラメーターをマネージド シグネチャの out パラメーターとして保持します。

Tlbimp.exe (タイプ ライブラリ インポーター) もこの属性を適用します。タイプ ライブラリをインポートするときに、 属性を dispinterface に適用します。

注意

COM からマネージ コードへの相互運用が発生しObject、マネージド コードが クラスでPreserveSigAttributeマークされている場合、 の戻り値の型CurrencyGuidは クラスでPreserveSigAttributeサポートされません。 これらの条件の間に クラスで 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 (タイプ ライブラリ インポーター)