System.Runtime.InteropServices Namespace

Fornece uma ampla variedade de membros que oferecem suporte a serviços de invocação de plataforma e interoperabilidade COM. Se você não estiver familiarizado com esses serviços, consulte Interoperação com código não gerenciado.

Classes

AllowReversePInvokeCallsAttribute	Permite que um método não gerenciado chame um método gerenciado.
AutomationProxyAttribute	Especifica se o tipo deve ter o marshaling realizado usando o marshaler de Automação ou um proxy e stub personalizados.
BestFitMappingAttribute	Controla se os caracteres Unicode são convertidos em caracteres ANSI correspondentes mais próximos.
BStrWrapper	Realiza marshaling de dados do tipo VT_BSTR de código gerenciado para código não gerenciado. Essa classe não pode ser herdada.
ClassInterfaceAttribute	Indica o tipo de interface de classe a ser gerado para uma classe exposta ao COM, se uma interface for de fato gerada.
CoClassAttribute	Especifica o identificador de classe de coclass importado de uma biblioteca de tipos.
CollectionsMarshal	Uma classe não segura que fornece um conjunto de métodos para acessar as representações de dados subjacentes de coleções.
ComAliasNameAttribute	Indica o alias COM de um parâmetro ou tipo de campo.
ComAwareEventInfo	Permite o registro de associação tardia de um manipulador de eventos.
ComCompatibleVersionAttribute	Indica a um cliente COM que todas as classes na versão atual de um assembly são compatíveis com as classes em uma versão anterior do assembly.
ComConversionLossAttribute	Indica que informações sobre uma classe ou interface foram perdidas quando foram importadas de uma biblioteca de tipos para um assembly.
ComDefaultInterfaceAttribute	Especifica uma interface padrão para expor ao COM. Essa classe não pode ser herdada.
ComEventInterfaceAttribute	Identifica a interface de origem e a classe que implementa os métodos da interface do evento é gerado quando uma coclass é importada de uma biblioteca de tipos COM.
ComEventsHelper	Fornece métodos que permitem que os delegados do .NET que tratam os eventos sejam adicionados e removidos dos objetos COM.
COMException	A exceção é lançada quando um HRESULT não reconhecido retorna de uma chamada de método COM.
ComImportAttribute	Indica que o tipo de atributo foi definido anteriormente na COM.
ComRegisterFunctionAttribute	Especifica o método a ser chamado quando você registra um assembly para ser usado de COM. Isso habilita a execução de código escrito pelo usuário durante o processo de registro.
ComSourceInterfacesAttribute	Identifica uma lista de interfaces que são expostas como origens de evento COM para a classe atribuída.
ComUnregisterFunctionAttribute	Especifica o método a ser chamado quando você cancela o registro de um assembly para uso de COM. Isso possibilita a execução de código escrito pelo usuário durante o processo de cancelamento do registro.
ComVisibleAttribute	Controla a acessibilidade de um tipo gerenciado individual ou membro, ou então de todos os tipos em um assembly, ao COM.
ComWrappers	Classe para gerenciar wrappers de tipos COM IUnknown.
CriticalHandle	Representa uma classe wrapper para os recursos do identificador.
CurrencyWrapper	Encapsula objetos que o empacotador deve realizar marshaling como um VT_CY.
DefaultCharSetAttribute	Especifica o valor da enumeração CharSet. Essa classe não pode ser herdada.
DefaultDllImportSearchPathsAttribute	Especifica os caminhos que são usados para procurar DLLs que fornecem funções para invocações de plataforma.
DefaultParameterValueAttribute	Define o valor padrão de um parâmetro, quando chamado de uma linguagem que dá suporte a parâmetros padrão. Essa classe não pode ser herdada.
DispatchWrapper	Encapsula objetos que o empacotador deve realizar marshaling como um VT_DISPATCH.
DispIdAttribute	Especifica o identificador de distribuição (DISPID) COM de um método, campo ou propriedade.
DllImportAttribute	Indica que o método atribuído é exposto por uma DLL (biblioteca de vínculo dinâmico) não gerenciada como um ponto de entrada estático.
DynamicInterfaceCastableImplementationAttribute	Atributo exigido por qualquer tipo retornado por GetInterfaceImplementation(RuntimeTypeHandle).
ErrorWrapper	Encapsula objetos que o empacotador deve realizar marshaling como um VT_ERROR.
ExternalException	O tipo de exceção de base para todas as exceções de interoperabilidade COM e exceções estruturadas de manipulação de exceção (SEH).
FieldOffsetAttribute	Indica a posição física dos campos dentro de representação não gerenciada de uma classe ou estrutura.
GuidAttribute	Fornece um Guid explícito quando um GUID automático for indesejável.
HandleCollector	Rastreia identificadores pendentes e força uma coleta de lixo quando é atingido o limite especificado.
ImmutableCollectionsMarshal	Uma classe insegura que fornece um conjunto de métodos para acessar as representações de dados subjacentes de coleções imutáveis.
ImportedFromTypeLibAttribute	Indica que os tipos definidos dentro de um assembly foram originalmente definidos em uma biblioteca de tipos.
InAttribute	Indica que os dados devem passar por marshaling pelo chamador para o receptor, mas não de volta para o chamador.
InterfaceTypeAttribute	Indica se uma interface gerenciada é dupla, somente de expedição ou somente de IUnknown quando exposta à COM.
InvalidComObjectException	A exceção lançada quando um objeto COM inválido é usado.
InvalidOleVariantTypeException	A exceção gerada pelo marshaler quando este encontra um argumento de um tipo variante que não pode ter o marshaling realizado no código gerenciado.
LCIDConversionAttribute	Indica que a assinatura não gerenciada do método espera um parâmetro LCID (identificador de localidade).
LibraryImportAttribute	Indica que um gerador de origem deve criar uma função para argumentos de marshalling em vez de depender do runtime para gerar uma função de marshalling equivalente em tempo de execução.
ManagedToNativeComInteropStubAttribute	Dá suporte para personalização do usuário de stubs de interoperabilidade em cenários de interoperabilidade gerenciada para COM.
Marshal	Fornece um conjunto de métodos para alocar a memória não gerenciada, copiando os blocos de memória não gerenciada e convertendo tipos gerenciados em não gerenciados, bem como outros diversos métodos usados ao interagir com código não gerenciado.
MarshalAsAttribute	Indica como realizar marshaling de dados entre código gerenciado e não gerenciado.
MarshalDirectiveException	A exceção que é lançada pelo marshaler quando este encontra um MarshalAsAttribute ao qual não oferece suporte.
MemoryMarshal	Fornece métodos para interoperar com Memory<T>, ReadOnlyMemory<T>, Span<T>e ReadOnlySpan<T>.
NativeLibrary	Fornece APIs para gerenciar bibliotecas nativas.
NativeMemory	Essa classe contém métodos que são usados principalmente para gerenciar a memória nativa.
OptionalAttribute	Indica que um parâmetro é opcional.
OutAttribute	Indica que os dados devem passar por marshaling do receptor de volta ao chamador.
PosixSignalContext	Fornece dados para um PosixSignalRegistration evento.
PosixSignalRegistration	Manipula um PosixSignal.
PreserveSigAttribute	Indica que a transformação de assinatura HRESULT que ocorre durante as chamadas de interoperabilidade COM deve ser suprimida.
PrimaryInteropAssemblyAttribute	Indica que o assembly atribuído é um assembly de interoperabilidade primário.
ProgIdAttribute	Permite que o usuário especifique o ProgID de uma classe.
RuntimeEnvironment	Fornece uma coleção de métodos static que retornam informações sobre o ambiente de Common Language Runtime.
RuntimeInformation	Fornece informações sobre a instalação do runtime .NET.
SafeArrayRankMismatchException	A exceção gerada quando a classificação de um SAFEARRAY de entrada não corresponde à classificação especificada na assinatura gerenciada.
SafeArrayTypeMismatchException	A exceção gerada quando o tipo de SAFEARRAY de entrada não corresponde ao tipo especificado na assinatura gerenciada.
SafeBuffer	Fornece um buffer de memória controlado que pode ser usado para leitura e gravação. Tentativas de acessar a memória fora do buffer controlado (falhas e estouros) geram exceções.
SafeHandle	Representa uma classe wrapper para identificadores do sistema operacional. Essa classe deve ser herdada.
SEHException	Representa erros de SEH (Manipulação de Exceção Estruturada).
SequenceMarshal	Fornece uma coleção de métodos para interoperar com o ReadOnlySequence<T>.
StandardOleMarshalObject	Substitui o marshaler free-thread padrão do CLR (Common Language Runtime) pelo marshaler OLE STA padrão.
StructLayoutAttribute	Permite controlar o layout físico dos campos de dados de uma classe ou estrutura na memória.
SuppressGCTransitionAttribute	Indica que uma transição de coleta de lixo deverá ser ignorada quando uma chamada de função não gerenciada for feita.
TypeIdentifierAttribute	Dá suporte à equivalência de tipo.
TypeLibFuncAttribute	Contém o FUNCFLAGS que foi originalmente importado para esse método da biblioteca de tipos COM.
TypeLibImportClassAttribute	Especifica qual Type usa exclusivamente uma interface. Essa classe não pode ser herdada.
TypeLibTypeAttribute	Contém o TYPEFLAGS que foi originalmente importado para esse tipo da biblioteca de tipos COM.
TypeLibVarAttribute	Contém o VARFLAGS que foi originalmente importado para esse campo da biblioteca de tipos COM.
TypeLibVersionAttribute	Especifica o número de versão de uma biblioteca de tipos exportada.
UnknownWrapper	Encapsula objetos que o empacotador deve realizar marshaling como um VT_UNKNOWN.
UnmanagedCallConvAttribute	Especifica a convenção de chamada necessária para chamar métodos P/Invoke implementados em código não gerenciado.
UnmanagedCallersOnlyAttribute	Métodos marcados com UnmanagedCallersOnlyAttribute podem ser chamados diretamente do código nativo. É possível carregar o token de função em uma variável local usando o operador address-of no C# e transmiti-lo como um retorno de chamada para um método nativo.
UnmanagedFunctionPointerAttribute	Controla o comportamento de marshaling de uma assinatura do delegado passado como um ponteiro de função não gerenciada de ou para código não gerenciado. Essa classe não pode ser herdada.
VariantWrapper	Realiza marshaling de dados do tipo VT_VARIANT | VT_BYREF de código gerenciado para código não gerenciado. Essa classe não pode ser herdada.

Estruturas

ArrayWithOffset	Encapsula uma matriz e um deslocamento dentro da matriz especificada.
CLong	CLong é um tipo de valor imutável que representa o long tipo em C e C++. Ele deve ser usado como um tipo de troca no limite gerenciado/não gerenciado para representar com precisão em APIs não gerenciadas de código gerenciado que usam o long tipo. Esse tipo tem 32 bits de armazenamento em todas as plataformas Windows e plataformas baseadas em Unix de 32 bits. Ele tem 64 bits de armazenamento em plataformas Unix de 64 bits.
ComWrappers.ComInterfaceDispatch	Uma interface binária de aplicativo para expedição de função de uma interface COM.
ComWrappers.ComInterfaceEntry	Tipo de interface e ponteiro para a Vtable de destino.
CULong	CULong é um tipo de valor imutável que representa o unsigned long tipo em C e C++. Ele deve ser usado como um tipo de troca no limite gerenciado/não gerenciado para representar com precisão em APIs não gerenciadas de código gerenciado que usam o unsigned long tipo. Esse tipo tem 32 bits de armazenamento em todas as plataformas Windows e plataformas baseadas em Unix de 32 bits. Ele tem 64 bits de armazenamento em plataformas Unix de 64 bits.
GCHandle	Fornece uma maneira de acessar um objeto gerenciado de memória não gerenciada.
HandleRef	Encapsula um objeto gerenciado que contém um identificador para um recurso que é passado para código não gerenciado usando a invocação de plataforma.
NFloat	NFloat é um tipo de valor imutável que representa um tipo flutuante que tem o mesmo tamanho que o tamanho inteiro nativo. Ele deve ser usado como um tipo de troca no limite gerenciado/não gerenciado para representar com precisão em APIs não gerenciadas de código gerenciado que usam um alias de tipo para C ou C++'s float em plataformas de 32 bits ou double em plataformas de 64 bits, como o tipo CGFloat em bibliotecas fornecidas pela Apple.
OSPlatform	Representa uma plataforma do sistema operacional.

Interfaces

ICustomAdapter	Fornece uma maneira para que os clientes acessem o objeto real, em vez do objeto adaptador entregue por um marshaler personalizado.
ICustomFactory	Permite que usuários gravem o código de ativação para os objetos gerenciados que estendem MarshalByRefObject.
ICustomMarshaler	Fornece wrappers personalizados para manipular chamadas de método.
ICustomQueryInterface	Habilita os desenvolvedores a fornecerem uma implementação personalizada gerenciada do método IUnknown::QueryInterface(REFIID riid, void **ppvObject).
IDynamicInterfaceCastable	Interface usada para participar de uma falha de conversão de tipo.

Enumerações

Architecture	Indica a arquitetura do processador.
CallingConvention	Especifica a convenção de chamada necessária para chamar os métodos implementados em código não gerenciado.
CharSet	Impõe qual conjunto de caracteres as cadeias de caracteres com marshaling devem usar.
ClassInterfaceType	Identifica o tipo de interface de classe que é gerado para uma classe.
ComInterfaceType	Identifica como expor uma interface a COM.
ComMemberType	Descreve o tipo de um membro de COM.
CreateComInterfaceFlags	Especifica os sinalizadores para o método GetOrCreateComInterfaceForObject(Object, CreateComInterfaceFlags).
CreateObjectFlags	Especifica os sinalizadores para o método GetOrCreateObjectForComInstance(IntPtr, CreateObjectFlags).
CustomQueryInterfaceMode	Indica se as chamadas de IUnknown::QueryInterface do método GetComInterfaceForObject(Object, Type, CustomQueryInterfaceMode) podem usar a interface ICustomQueryInterface.
CustomQueryInterfaceResult	Fornece valores retornados para o método GetInterface(Guid, IntPtr).
DllImportSearchPath	Especifica os caminhos que são usados para procurar DLLs que fornecem funções para invocações de plataforma.
GCHandleType	Representa os tipos de identificadores que o GCHandle tipo pode alocar.
LayoutKind	Controla o layout de um objeto quando exportado para o código não gerenciado.
PosixSignal	Especifica um número de sinal POSIX.
StringMarshalling	Especifica como as cadeias de caracteres devem ser empacotadas para p/invokes gerados
TypeLibFuncFlags	Descreve as configurações originais do FUNCFLAGS na biblioteca de tipos COM da qual esse método foi importado.
TypeLibTypeFlags	Descreve as configurações originais do TYPEFLAGS na biblioteca de tipos COM da qual esse tipo foi importado.
TypeLibVarFlags	Descreve as configurações originais do VARFLAGS na biblioteca de tipos COM de que a variável foi importada.
UnmanagedType	Identifica como realizar marshaling de parâmetros ou campos para código não gerenciado.
VarEnum	Indica como realizar marshaling dos elementos da matriz quando uma matriz passa por marshaling do código gerenciado para não gerenciado como um SafeArray.

Delegados

DllImportResolver

Fornece um delegado usado para resolver bibliotecas nativas por meio de retorno de chamada.

Comentários

Os membros desse namespace fornecem várias categorias de funcionalidade, conforme mostrado na tabela a seguir. Atributos controlam o comportamento de marshaling, como organizar estruturas ou como representar cadeias de caracteres. Os atributos mais importantes são DllImportAttribute, que você usa para definir métodos de invocação de plataforma para acessar APIs não gerenciadas e MarshalAsAttribute, que você usa para especificar como os dados são empacotados entre memória gerenciada e não gerenciada.