System.Runtime.InteropServices Przestrzeń nazw

Zapewnia szeroką gamę elementów członkowskich, które obsługują międzyoperację modelu COM i platformę wywoływania usług. Jeśli nie znasz tych usług, zobacz Współdziałanie z niezarządzanymi kodami.

Klasy

Nazwa	Opis
AllowReversePInvokeCallsAttribute	Umożliwia niezarządzanej metodzie wywoływanie metody zarządzanej.
AutomationProxyAttribute	Określa, czy typ ma być marshalerem usługi Automation, czy niestandardowym serwerem proxy i wycinką.
BestFitMappingAttribute	Określa, czy znaki Unicode są konwertowane na najbliższe pasujące znaki ANSI.
BStrWrapper	Marshaluje dane typu VT_BSTR z zarządzanego do niezarządzanego kodu. Tej klasy nie można dziedziczyć.
ClassInterfaceAttribute	Wskazuje typ interfejsu klasy, który ma zostać wygenerowany dla klasy uwidocznionej w modelu COM, jeśli w ogóle zostanie wygenerowany interfejs.
CoClassAttribute	Określa identyfikator klasy coclass zaimportowany z biblioteki typów.
CollectionsMarshal	Niebezpieczna klasa, która udostępnia zestaw metod uzyskiwania dostępu do podstawowych reprezentacji danych kolekcji.
ComAliasNameAttribute	Wskazuje alias COM dla parametru lub typu pola.
ComAwareEventInfo	Zezwala na późną rejestrację programu obsługi zdarzeń.
ComCompatibleVersionAttribute	Wskazuje klientowi COM, że wszystkie klasy w bieżącej wersji zestawu są zgodne z klasami we wcześniejszej wersji zestawu.
ComConversionLossAttribute	Wskazuje, że informacje zostały utracone o klasie lub interfejsie podczas importowania ich z biblioteki typów do zestawu.
ComDefaultInterfaceAttribute	Określa interfejs domyślny do uwidocznienia modelu COM. Tej klasy nie można dziedziczyć.
ComEventInterfaceAttribute	Identyfikuje interfejs źródłowy i klasę, która implementuje metody interfejsu zdarzeń generowanego podczas importowania coclass z biblioteki typów COM.
ComEventsHelper	Udostępnia metody, które umożliwiają delegatom platformy .NET obsługę zdarzeń do dodania i usunięcia z obiektów COM.
COMException	Wyjątek, który jest zgłaszany, gdy nierozpoznany HRESULT jest zwracany z wywołania metody COM.
ComImportAttribute	Wskazuje, że typ atrybutu został wcześniej zdefiniowany w modelu COM.
ComRegisterFunctionAttribute	Określa metodę wywoływania podczas rejestrowania zestawu do użycia z modelu COM; umożliwia wykonywanie kodu napisanego przez użytkownika podczas procesu rejestracji.
ComSourceInterfacesAttribute	Identyfikuje listę interfejsów, które są uwidocznione jako źródła zdarzeń COM dla klasy przypisanej.
ComUnregisterFunctionAttribute	Określa metodę wywoływania podczas wyrejestrowania zestawu do użycia z modelu COM; Umożliwia to wykonywanie kodu napisanego przez użytkownika podczas procesu wyrejestrowania.
ComVisibleAttribute	Steruje ułatwieniami dostępu pojedynczego typu zarządzanego lub elementu członkowskiego lub wszystkich typów w zestawie do modelu COM.
ComWrappers	Klasa do zarządzania otokami typów IUnknown COM.
CriticalHandle	Reprezentuje klasę otoki do obsługi zasobów.
CurrencyWrapper	Zawija obiekty marshaler powinien być marshalerem jako element VT_CY.
DefaultCharSetAttribute	Określa wartość wyliczenia CharSet. Tej klasy nie można dziedziczyć.
DefaultDllImportSearchPathsAttribute	Określa ścieżki, które są używane do wyszukiwania bibliotek DLL, które zapewniają funkcje dla wywołań platformy.
DefaultParameterValueAttribute	Ustawia wartość domyślną parametru, gdy jest wywoływany z języka, który obsługuje parametry domyślne. Tej klasy nie można dziedziczyć.
DispatchWrapper	Zawija obiekty marshaler powinien być marshalerem jako element VT_DISPATCH.
DispIdAttribute	Określa identyfikator dyspozytora COM (DISPID) metody, pola lub właściwości.
DllImportAttribute	Wskazuje, że metoda przypisana jest uwidoczniona przez niezarządzaną bibliotekę łącza dynamicznego (DLL) jako statyczny punkt wejścia.
DynamicInterfaceCastableImplementationAttribute	Atrybut wymagany przez dowolny typ zwracany przez GetInterfaceImplementation(RuntimeTypeHandle).
ErrorWrapper	Zawija obiekty marshaler powinien być marshalerem jako element VT_ERROR.
ExternalException	Podstawowy typ wyjątku dla wszystkich wyjątków międzyoperacyjnej modelu COM i wyjątków obsługi wyjątków strukturalnych (SEH).
FieldOffsetAttribute	Wskazuje fizyczne położenie pól w niezarządzanej reprezentacji klasy lub struktury.
GCHandleExtensions	Udostępnia metody rozszerzenia do obsługi z uchwytami GC.
GuidAttribute	Dostarcza jawne Guid, gdy automatyczny identyfikator GUID jest niepożądany.
HandleCollector	Śledzi zaległe uchwyty i wymusza odzyskiwanie pamięci po osiągnięciu określonego progu.
ImmutableCollectionsMarshal	Niebezpieczna klasa, która udostępnia zestaw metod uzyskiwania dostępu do bazowych reprezentacji danych kolekcji niezmiennych.
ImportedFromTypeLibAttribute	Wskazuje, że typy zdefiniowane w zestawie zostały pierwotnie zdefiniowane w bibliotece typów.
InAttribute	Wskazuje, że dane powinny być marshalowane z obiektu wywołującego do wywoływanego, ale nie z powrotem do obiektu wywołującego.
InterfaceTypeAttribute	Wskazuje, czy interfejs zarządzany jest podwójny, tylko do wysyłania, czy IUnknown -only, gdy jest uwidoczniony w modelu COM.
InvalidComObjectException	Wyjątek zgłaszany, gdy jest używany nieprawidłowy obiekt COM.
InvalidOleVariantTypeException	Wyjątek zgłaszany przez marshalera, gdy napotka argument typu wariantu, którego nie można marshalingować do kodu zarządzanego.
JsonMarshal	Niebezpieczna klasa, która udostępnia zestaw metod uzyskiwania dostępu do podstawowych reprezentacji danych typów JSON.
LCIDConversionAttribute	Wskazuje, że sygnatura niezarządzana metody oczekuje parametru identyfikatora ustawień regionalnych (LCID).
LibraryImportAttribute	Wskazuje, że generator źródła powinien utworzyć funkcję do argumentów marshalling zamiast polegać na środowisku uruchomieniowym w celu wygenerowania równoważnej funkcji marshalling w czasie wykonywania.
ManagedToNativeComInteropStubAttribute	Zapewnia obsługę dostosowywania przez użytkownika wycinków międzyoperacyjnych w scenariuszach międzyoperacyjności zarządzanych do modelu COM.
Marshal	Udostępnia kolekcję metod przydzielania niezarządzanej pamięci, kopiowania niezarządzanych bloków pamięci i konwertowania zarządzanych na typy niezarządzane, a także innych różnych metod używanych podczas interakcji z kodem niezarządzanym.
MarshalAsAttribute	Wskazuje sposób marshalingu danych między kodem zarządzanym i niezarządzanych.
MarshalDirectiveException	Wyjątek zgłaszany przez marshalera, gdy napotka element MarshalAsAttribute , który nie obsługuje.
MemoryMarshal	Udostępnia metody współdziałania z metodami Memory<T>, ReadOnlyMemory<T>, Span<T>i ReadOnlySpan<T>.
NativeLibrary	Udostępnia interfejsy API do zarządzania bibliotekami natywnymi.
NativeMemory	Ta klasa zawiera metody, które są używane głównie do zarządzania pamięcią natywną.
OptionalAttribute	Wskazuje, że parametr jest opcjonalny.
OutAttribute	Wskazuje, że dane powinny być marshalowane z wywołania z powrotem do obiektu wywołującego.
PosixSignalContext	Dostarcza dane dla PosixSignalRegistration zdarzenia.
PosixSignalRegistration	Obsługuje element PosixSignal.
PreserveSigAttribute	Wskazuje, że transformacja podpisu HRESULT, która odbywa się podczas wywołań międzyoperacyjności modelu COM, powinna zostać pominięta.
PrimaryInteropAssemblyAttribute	Wskazuje, że zestaw przypisany jest podstawowym zestawem międzyoperacyjnym.
ProgIdAttribute	Umożliwia użytkownikowi określenie wartości ProgID klasy.
RuntimeEnvironment	Udostępnia kolekcję static metod, które zwracają informacje o środowisku uruchomieniowym języka wspólnego.
RuntimeInformation	Zawiera informacje o instalacji środowiska uruchomieniowego platformy .NET.
SafeArrayRankMismatchException	Wyjątek zgłaszany, gdy ranga przychodzącego SAFEARRAY nie jest zgodna z rangą określoną w podpisie zarządzanym.
SafeArrayTypeMismatchException	Wyjątek zgłaszany, gdy typ przychodzącego SAFEARRAY nie jest zgodny z typem określonym w podpisie zarządzanym.
SafeBuffer	Zapewnia kontrolowany bufor pamięci, który może służyć do odczytywania i zapisywania. Próby uzyskania dostępu do pamięci poza kontrolowanym buforem (underruns i overruns) zgłaszają wyjątki.
SafeHandle	Reprezentuje klasę otoki dla uchwytów systemu operacyjnego. Ta klasa musi być dziedziczona.
SEHException	Reprezentuje błędy obsługi wyjątków strukturalnych (SEH).
SequenceMarshal	Udostępnia kolekcję metod do współdziałania z ReadOnlySequence<T>programem .
StandardOleMarshalObject	Zastępuje standardowy marshaler języka wspólnego (CLR) bezwątkowy ze standardowym marshalerem OLE STA.
StructLayoutAttribute	Umożliwia sterowanie fizycznym układem pól danych klasy lub struktury w pamięci.
SuppressGCTransitionAttribute	Wskazuje, że przejście odzyskiwania pamięci powinno zostać pominięte po utworzeniu niezarządzanego wywołania funkcji.
TypeIdentifierAttribute	Zapewnia obsługę równoważności typów.
TypeLibFuncAttribute	Zawiera FUNCFLAGS, które zostały pierwotnie zaimportowane dla tej metody z biblioteki typów COM.
TypeLibImportClassAttribute	Określa, który Type używa wyłącznie interfejsu. Tej klasy nie można dziedziczyć.
TypeLibTypeAttribute	Zawiera TYPEFLAGS, które zostały pierwotnie zaimportowane dla tego typu z biblioteki typów COM.
TypeLibVarAttribute	Zawiera VARFLAGS, które zostały pierwotnie zaimportowane dla tego pola z biblioteki typów COM.
TypeLibVersionAttribute	Określa numer wersji wyeksportowanej biblioteki typów.
TypeMapAssemblyTargetAttribute<TTypeMapGroup>	Reprezentuje atrybut, który deklaruje, że zestaw powinien być sprawdzany podczas kompilowania mapy typów.
TypeMapAssociationAttribute<TTypeMapGroup>	Reprezentuje atrybut, który tworzy skojarzenie typu między typem a jego serwerem proxy.
TypeMapAttribute<TTypeMapGroup>	Reprezentuje atrybut definiujący mapowanie typów między ciągiem a typem.
TypeMapping	Reprezentuje typ wpisu dla logiki mapowania typów międzyoperacyjnej.
UnknownWrapper	Zawija obiekty marshaler powinien być marshalerem jako element VT_UNKNOWN.
UnmanagedCallConvAttribute	Określa konwencję wywoływania wymaganą do wywoływania metod P/Invoke zaimplementowanych w kodzie niezarządzanych.
UnmanagedCallersOnlyAttribute	Dowolna metoda oznaczona UnmanagedCallersOnlyAttribute może być wywoływana bezpośrednio z kodu natywnego. Token funkcji można załadować do zmiennej lokalnej przy użyciu adresu operatora w języku C# i przekazanego jako wywołanie zwrotne do metody natywnej.
UnmanagedFunctionPointerAttribute	Steruje działaniem marshalingu sygnatury delegowanej przekazanej jako niezarządzany wskaźnik funkcji do lub z niezarządzanego kodu. Tej klasy nie można dziedziczyć.
VariantWrapper	Marshaluje dane typu VT_VARIANT | VT_BYREF z zarządzanego do niezarządzanego kodu. Tej klasy nie można dziedziczyć.
WasmImportLinkageAttribute	Określa, że P/Invoke oznaczony tym atrybutem powinien być połączony jako import WASM.

Struktury

Nazwa	Opis
ArrayWithOffset	Hermetyzuje tablicę i przesunięcie w określonej tablicy.
CLong	CLong jest niezmiennym typem wartości reprezentującym long typ w językach C i C++. Ma być używany jako typ wymiany w granicach zarządzanych/niezarządzanych w celu dokładnego reprezentowania w niezarządzanych interfejsach API kodu zarządzanego long , które używają tego typu. Ten typ ma 32-bitowe magazyny na wszystkich platformach windows i 32-bitowych platformach unix. Ma 64-bitowe miejsca do magazynowania na 64-bitowych platformach Unix.
ComWrappers.ComInterfaceDispatch	Interfejs binarny aplikacji do wysyłania funkcji interfejsu COM.
ComWrappers.ComInterfaceEntry	Typ interfejsu i wskaźnik do docelowej tabeli wirtualnej.
CULong	CULong jest niezmiennym typem wartości reprezentującym unsigned long typ w językach C i C++. Ma być używany jako typ wymiany w granicach zarządzanych/niezarządzanych w celu dokładnego reprezentowania w niezarządzanych interfejsach API kodu zarządzanego unsigned long , które używają tego typu. Ten typ ma 32-bitowe magazyny na wszystkich platformach windows i 32-bitowych platformach unix. Ma 64-bitowe miejsca do magazynowania na 64-bitowych platformach Unix.
GCHandle	Zapewnia sposób uzyskiwania dostępu do obiektu zarządzanego z niezarządzanej pamięci.
GCHandle<T>	Reprezentuje silnie typizowane dojście GC do zarządzanego obiektu.
HandleRef	Opakowuje zarządzany obiekt przechowujący uchwyt do zasobu, który jest przekazywany do niezarządzanego kodu przy użyciu wywołania platformy.
NFloat	NFloat jest niezmiennym typem wartości reprezentującym typ zmiennoprzecinkowy o takim samym rozmiarze jak natywna liczba całkowita. Ma być używany jako typ wymiany na zarządzanych/niezarządzanych granicach, aby dokładnie reprezentować w niezarządzanych interfejsach API kodu zarządzanego, które używają aliasu typu dla platform C lub C++ float na platformach 32-bitowych lub double na platformach 64-bitowych, takich jak typ CGFloat w bibliotekach udostępnianych przez firmę Apple.
OSPlatform	Reprezentuje platformę systemu operacyjnego.
PinnedGCHandle<T>	Reprezentuje silnie typizowane dojście GC do zarządzanego obiektu.
WeakGCHandle<T>	Reprezentuje silnie typizowane dojście GC do zarządzanego obiektu.

Interfejsy

Nazwa	Opis
ICustomAdapter	Zapewnia klientom sposób uzyskiwania dostępu do rzeczywistego obiektu, a nie obiektu adaptera przekazanego przez niestandardowego marshalera.
ICustomFactory	Umożliwia użytkownikom pisanie kodu aktywacji dla obiektów zarządzanych, które rozszerzają element MarshalByRefObject.
ICustomMarshaler	Udostępnia niestandardowe otoki do obsługi wywołań metod.
ICustomQueryInterface	Umożliwia deweloperom udostępnianie niestandardowej, zarządzanej implementacji metody IUnknown::QueryInterface(REFIID riid, void **ppvObject).
IDynamicInterfaceCastable	Interfejs używany do udziału w błędzie rzutowania typu.

Wyliczenia

Nazwa	Opis
Architecture	Wskazuje architekturę procesora.
CallingConvention	Określa konwencję wywoływania wymaganą do wywoływania metod zaimplementowanych w kodzie niezarządzanych.
CharSet	Określa, który zestaw znaków powinien używać ciągów marshalowanych.
ClassInterfaceType	Określa typ interfejsu klasy, który jest generowany dla klasy.
ComInterfaceType	Określa sposób uwidaczniania interfejsu com.
ComMemberType	Opisuje typ elementu członkowskiego COM.
CreateComInterfaceFlags	Określa flagi dla metody GetOrCreateComInterfaceForObject(Object, CreateComInterfaceFlags).
CreatedWrapperFlags	Określa flagi dla CreateObject(IntPtr, CreateObjectFlags, Object, CreatedWrapperFlags).
CreateObjectFlags	Określa flagi dla metody GetOrCreateObjectForComInstance(IntPtr, CreateObjectFlags).
CustomQueryInterfaceMode	Wskazuje, czy wywołania metody GetComInterfaceForObject(Object, Type, CustomQueryInterfaceMode)IUnknown::QueryInterface mogą używać interfejsu ICustomQueryInterface.
CustomQueryInterfaceResult	Udostępnia wartości zwracane dla metody GetInterface(Guid, IntPtr).
DllImportSearchPath	Określa ścieżki, które są używane do wyszukiwania bibliotek DLL, które zapewniają funkcje dla wywołań platformy.
GCHandleType	Reprezentuje typy dojść, które mogą przydzielić typ GCHandle.
LayoutKind	Steruje układem obiektu podczas eksportowania do niezarządzanego kodu.
PosixSignal	Określa numer sygnału POSIX.
StringMarshalling	Określa sposób, w jaki ciągi powinny być rozdzielane dla wygenerowanych wywołań p/invoke
TypeLibFuncFlags	Opisuje oryginalne ustawienia FUNCFLAGS w bibliotece typów COM, z której ta metoda została zaimportowana.
TypeLibTypeFlags	Opisuje oryginalne ustawienia TYPEFLAGS w bibliotece typów COM, z której zaimportowano typ.
TypeLibVarFlags	Opisuje oryginalne ustawienia VARFLAGS w bibliotece typów COM, z której zaimportowano zmienną.
UnmanagedType	Określa sposób marshalingu parametrów lub pól do niezarządzanych kodów.
VarEnum	Wskazuje sposób marshalingu elementów tablicy, gdy tablica jest marshaled z zarządzanego do niezarządzanego kodu jako SafeArray.

Delegaci

Nazwa	Opis
DllImportResolver	Udostępnia delegata używanego do rozpoznawania bibliotek natywnych za pośrednictwem wywołania zwrotnego.

Uwagi

Elementy członkowskie tej przestrzeni nazw zapewniają kilka kategorii funkcjonalności, jak pokazano w poniższej tabeli. Atrybuty kontrolują zachowanie marshalingu, takie jak rozmieszczanie struktur lub sposób reprezentowania ciągów. Najważniejsze atrybuty to DllImportAttribute, które służą do definiowania metod wywoływania platformy na potrzeby uzyskiwania dostępu do niezarządzanych interfejsów API i MarshalAsAttribute, których używasz do określania sposobu marshalingu danych między zarządzaną i niezarządzaną pamięcią.