PreserveSigAttribute Kelas

Definisi

Ruang nama:

System.Runtime.InteropServices

Rakitan:

System.Runtime.InteropServices.dll

Sumber:

PreserveSigAttribute.cs

Menunjukkan bahwa transformasi tanda tangan HRESULT yang terjadi selama panggilan interop COM harus ditekan.

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

Warisan

Object

Attribute

PreserveSigAttribute

Atribut

AttributeUsageAttribute

Contoh

Contoh berikut menunjukkan bagaimana Tlbexp.exe mengonversi metode C# tanpa PreserveSigAttribute saat mengekspor rakitan ke pustaka jenis COM.

Tanda tangan terkelola:

int DoSomething (long l);  

Tanda tangan tidak terkelola:

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

Ketika Anda menerapkan PreserveSigAttribute ke metode C# yang sama dan mengekspor assembly, konversi metode berbeda dari contoh sebelumnya. Perhatikan bahwa Tlbexp.exe menghapus pengubah parameter HRESULT dan [out, retval].

Tanda tangan terkelola:

[PreserveSig] int DoSomething (long l);  

Tanda tangan tidak terkelola:

int DoSomething ([in] long l);  

Keterangan

Anda dapat menerapkan atribut ini ke metode.

Secara default, Tlbexp.exe (Pengekspor Pustaka Jenis) memastikan bahwa panggilan yang mengembalikan HRESULT S_OK ditransformasikan sehingga parameter [out, retval] digunakan sebagai nilai pengembalian fungsi. HRESULT S_OK dibuang. Untuk HRESULT selain S_OK, runtime melempar pengecualian dan membuang parameter [out, retval]. Saat Anda menerapkan ke PreserveSigAttribute tanda tangan metode terkelola, tanda tangan terkelola dan tidak terkelola dari metode yang diatribusikan identik.

Mempertahankan tanda tangan metode asli diperlukan jika anggota mengembalikan lebih dari satu nilai HRESULT yang berhasil dan Anda ingin mendeteksi nilai yang berbeda. Karena sebagian besar anggota COM mengembalikan HRESULT, dengan menerapkan PreserveSigAttribute, Anda dapat mengambil bilangan bulat yang mewakili HRESULT yang berhasil atau gagal. Tlbexp.exe mempertahankan parameter [out, retval] sebagai parameter keluar dalam tanda tangan terkelola.

Tlbimp.exe (Type Library Importer) juga menerapkan atribut ini; ini menerapkan atribut ke dispinterfaces ketika mengimpor pustaka jenis.

Catatan

Mengembalikan jenis Currency, , dan Object tidak didukung oleh PreserveSigAttribute kelas ketika interoperatasi terjadi dari COM ke kode terkelola dan kode terkelola ditandai dengan PreserveSigAttributeGuidkelas . Ketika Anda mencoba menggunakan salah satu jenis pengembalian ini dengan PreserveSigAttribute kelas selama kondisi ini, akan TypeLoadException dilemparkan.

Konstruktor

PreserveSigAttribute()

Menginisialisasi instans baru kelas PreserveSigAttribute.

Properti

TypeId

Ketika diimplementasikan di kelas turunan, mendapatkan pengidentifikasi unik untuk ini Attribute. (Diperoleh dari Attribute)

Metode

Equals(Object)	Mengembalikan nilai yang menunjukkan apakah instans ini sama dengan objek tertentu. (Diperoleh dari Attribute)
GetHashCode()	Mengembalikan kode hash untuk instans ini. (Diperoleh dari Attribute)
GetType()	Mendapatkan instans Type saat ini. (Diperoleh dari Object)
IsDefaultAttribute()	Ketika ditimpa di kelas turunan, menunjukkan apakah nilai instans ini adalah nilai default untuk kelas turunan. (Diperoleh dari Attribute)
Match(Object)	Saat ditimpa di kelas turunan, mengembalikan nilai yang menunjukkan apakah instans ini sama dengan objek tertentu. (Diperoleh dari Attribute)
MemberwiseClone()	Membuat salinan dangkal dari yang saat ini Object. (Diperoleh dari Object)
ToString()	Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object)

Lihat juga

• Tlbexp.exe (Pengekspor Pustaka Jenis)
• Tlbimp.exe ( Pengimpor Pustaka Jenis)