PreserveSigAttribute Sınıf

Tanım

Ad Alanı:

System.Runtime.InteropServices

Bütünleştirilmiş Kod:

System.Runtime.InteropServices.dll

Kaynak:

PreserveSigAttribute.cs

COM birlikte çalışma çağrıları sırasında gerçekleşen HRESULT imza dönüştürmesinin gizlenmesi gerektiğini gösterir.

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

Devralma

Object

Attribute

PreserveSigAttribute

Öznitelikler

AttributeUsageAttribute

Örnekler

Aşağıdaki örnekte, Tlbexp.exe bir derleme com türü kitaplığına dışarı aktarılırken C# yöntemini PreserveSigAttribute nasıl dönüştürdüğü gösterilmektedir.

Yönetilen imza:

int DoSomething (long l);  

Yönetilmeyen imza:

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

Aynı C# yöntemine uyguladığınızda PreserveSigAttribute ve derlemeyi dışarı aktardığınızda, yöntem dönüştürmesi önceki örnekten farklıdır. Tlbexp.exe HRESULT ve [out, retval] parametre değiştiricisini kaldırır.

Yönetilen imza:

[PreserveSig] int DoSomething (long l);  

Yönetilmeyen imza:

int DoSomething ([in] long l);  

Açıklamalar

Bu özniteliği yöntemlere uygulayabilirsiniz.

Varsayılan olarak ,Tlbexp.exe (Tür Kitaplığı Dışarı Aktarıcısı) S_OK HRESULT döndüren bir çağrının[ out, retval] parametresi işlev dönüş değeri olarak kullanılacak şekilde dönüştürülmesini sağlar. HRESULT S_OK atılır. S_OK dışındaki HRESULTs için çalışma zamanı bir özel durum oluşturur ve [out, retval] parametresini atar. yönetilen PreserveSigAttribute yöntem imzasına uyguladığınızda, öznitelikli yöntemin yönetilen ve yönetilmeyen imzaları aynıdır.

Üye birden fazla başarılı HRESULT değeri döndürüyorsa ve farklı değerleri algılamak istiyorsanız, özgün yöntem imzasını korumak gerekir. Çoğu COM üyesi hresult döndüreceğinden, uygulamasını uygulayarak PreserveSigAttributebaşarı veya başarısızlık HRESULT değerini temsil eden bir tamsayı alabilirsiniz. Tlbexp.exe yönetilen imzada out parametreleri olarak [out, retval] parametrelerini korur.

Tlbimp.exe (Tür Kitaplığı İçeri Aktarıcısı) bu özniteliği de uygular; bir tür kitaplığını içeri aktarırken özniteliğini dispinterfaces'e uygular.

Not

COM'dan Currencyyönetilen koda birlikte çalışma gerçekleştiğinde ve Object yönetilen kod sınıfıyla PreserveSigAttribute işaretlendiğinde , Guidve dönüş türleri sınıfı tarafından PreserveSigAttribute desteklenmez. Bu koşullar sırasında sınıfıyla PreserveSigAttribute bu dönüş türlerinden birini kullanmayı denediğinizde, bir TypeLoadException oluşturulur.

Oluşturucular

PreserveSigAttribute()

PreserveSigAttribute sınıfının yeni bir örneğini başlatır.

Özellikler

TypeId

Türetilmiş bir sınıfta uygulandığında, bu Attributeiçin benzersiz bir tanımlayıcı alır. (Devralındığı yer: Attribute)

Yöntemler

Equals(Object)	Bu örneğin belirtilen bir nesneye eşit olup olmadığını gösteren bir değeri döndürür. (Devralındığı yer: Attribute)
GetHashCode()	Bu örneğe ilişkin karma kodu döndürür. (Devralındığı yer: Attribute)
GetType()	Type Geçerli örneğini alır. (Devralındığı yer: Object)
IsDefaultAttribute()	Türetilmiş bir sınıfta geçersiz kılındığında, bu örneğin değerinin türetilmiş sınıf için varsayılan değer olup olmadığını gösterir. (Devralındığı yer: Attribute)
Match(Object)	Türetilmiş bir sınıfta geçersiz kılındığında, bu örneğin belirtilen bir nesneye eşit olup olmadığını gösteren bir değer döndürür. (Devralındığı yer: Attribute)
MemberwiseClone()	Geçerli Objectöğesinin sığ bir kopyasını oluşturur. (Devralındığı yer: Object)
ToString()	Geçerli nesneyi temsil eden dizeyi döndürür. (Devralındığı yer: Object)

Ayrıca bkz.

• Tlbexp.exe (Tür Kitaplığı Dışarı Aktarıcı)
• Tlbimp.exe (Tür Kitaplığı İçeri Aktarıcı)