Marshal.CreateWrapperOfType Metodo

Definizione

Spazio dei nomi:

System.Runtime.InteropServices

Assembly:

System.Runtime.InteropServices.dll

Overload

CreateWrapperOfType(Object, Type)	Include l'oggetto COM specificato in un oggetto del tipo specificato.
CreateWrapperOfType<T,TWrapper>(T)	Include l'oggetto COM specificato in un oggetto del tipo specificato.

CreateWrapperOfType(Object, Type)

Origine:

Marshal.NoCom.cs

Include l'oggetto COM specificato in un oggetto del tipo specificato.

public:
 static System::Object ^ CreateWrapperOfType(System::Object ^ o, Type ^ t);

[System.Runtime.Versioning.SupportedOSPlatform("windows")]
public static object? CreateWrapperOfType (object? o, Type t);

[<System.Runtime.Versioning.SupportedOSPlatform("windows")>]
static member CreateWrapperOfType : obj * Type -> obj

Public Shared Function CreateWrapperOfType (o As Object, t As Type) As Object

Parametri

o

Object

Oggetto da includere.

t

Type

Tipo di wrapper da creare.

Restituisce

Object

L'oggetto appena incluso che è un'istanza del tipo desiderato.

Attributi

SupportedOSPlatformAttribute

Eccezioni

ArgumentException

t deve derivare da __ComObject.

-oppure-

t è un tipo Windows Runtime.

ArgumentNullException

Il valore del parametro t è null.

InvalidCastException

Non è possibile convertire o nel tipo di destinazione perché non supporta tutte le interfacce richieste.

Commenti

CreateWrapperOfType converte un tipo di classe COM, in genere il tipo di base __ComObject , in un altro tipo di classe COM. L'oggetto COM di input, rappresentato dal parametro o, è un Runtime Callable Wrapper (RCW).

Entrambi i t parametri e o devono essere classi le cui firme sono attribuite a System.Runtime.InteropServices.ComImportAttribute. Lo strumento Tlbimp.exe (utilità di importazione libreria dei tipi) applica questo attributo quando importa una libreria dei tipi. Se si crea manualmente rcw nel codice sorgente, è necessario applicare questo attributo alla firma gestita che rappresenta la coclasse originale per indicare le origini COM.

Tlbimp.exe importa una coclasse COM come classe gestita e un'interfaccia. L'interfaccia della coclasse ha lo stesso nome della coclasse originale e la classe gestita ha il nome della coclasse originale aggiunto con "Class". Ad esempio, una coclasse denominata MyCoclass diventa un'interfaccia di coclasse denominata MyCoclass e una classe gestita denominata MyCoclassClass. Poiché t deve essere una classe, non un'interfaccia, assicurarsi di specificare la classe gestita (MyCoclassClass) e non l'interfaccia della coclasse.

Nota

Si perde l'identità dell'oggetto COM di input perché una nuova istanza RCW esegue il wrapping del puntatore IUnknown esposto dall'RCW originale.

Vedi anche

• ComImportAttribute

CreateWrapperOfType<T,TWrapper>(T)

Origine:

Marshal.NoCom.cs

Include l'oggetto COM specificato in un oggetto del tipo specificato.

public:
generic <typename T, typename TWrapper>
 static TWrapper CreateWrapperOfType(T o);

[System.Runtime.Versioning.SupportedOSPlatform("windows")]
public static TWrapper CreateWrapperOfType<T,TWrapper> (T? o);

[<System.Runtime.Versioning.SupportedOSPlatform("windows")>]
static member CreateWrapperOfType : 'T -> 'Wrapper

Public Shared Function CreateWrapperOfType(Of T, TWrapper) (o As T) As TWrapper

Parametri di tipo

T

Tipo di oggetto di cui eseguire il wrapping.

TWrapper

Tipo di oggetto da restituire.

Parametri

o

T

Oggetto da includere.

Restituisce

TWrapper

Oggetto appena incluso.

Attributi

SupportedOSPlatformAttribute

Eccezioni

ArgumentException

T deve derivare da __ComObject.

-oppure-

T è un tipo Windows Runtime.

InvalidCastException

o non può essere convertito in TWrapper perché non supporta tutte le interfacce richieste.

Commenti

CreateWrapperOfType<T,TWrapper>(T) converte un oggetto COM di tipo T nel TWrapper tipo di classe COM. L'oggetto COM di input, rappresentato dal parametro o, è un Runtime Callable Wrapper (RCW).

Sia il T parametro di tipo generico che il o parametro devono essere classi le cui firme sono attribuite con l'attributo System.Runtime.InteropServices.ComImportAttribute . Lo strumento Tlbimp.exe (utilità di importazione libreria dei tipi) applica questo attributo quando importa una libreria dei tipi. Se si crea manualmente rcw nel codice sorgente, è necessario applicare questo attributo alla firma gestita che rappresenta la coclasse originale per indicare le origini COM.

Tlbimp.exe importa una coclasse COM come classe gestita e un'interfaccia. L'interfaccia della coclasse ha lo stesso nome della coclasse originale e la classe gestita ha il nome della coclasse originale aggiunto con "Class". Ad esempio, una coclasse denominata MyCoclass diventa un'interfaccia di coclasse denominata MyCoclass e una classe gestita denominata MyCoclassClass. PoichéT deve essere una classe, non un'interfaccia, assicurarsi di specificare la classe gestita (MyCoclassClass) e non l'interfaccia coclass .

Nota

Si perde l'identità dell'oggetto COM di input, perché una nuova istanza RCW esegue il wrapping del puntatore IUnknown esposto dall'RCW originale.