Marshal.DestroyStructure Methode
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
| DestroyStructure(IntPtr, Type) |
Veraltet.
Gibt alle Unterstrukturen frei, auf die der angegebene nicht verwaltete Speicherblock zeigt. |
| DestroyStructure<T>(IntPtr) |
Gibt alle Unterstrukturen eines angegebenen Typs frei, auf die der angegebene nicht verwaltete Speicherblock zeigt. |
- Quelle:
- Marshal.cs
- Quelle:
- Marshal.cs
- Quelle:
- Marshal.CoreCLR.cs
Achtung
DestroyStructure(IntPtr, Type) may be unavailable in future releases. Instead, use DestroyStructure<T>(IntPtr). For more info, go to http://go.microsoft.com/fwlink/?LinkID=296520
Gibt alle Unterstrukturen frei, auf die der angegebene nicht verwaltete Speicherblock zeigt.
public:
static void DestroyStructure(IntPtr ptr, Type ^ structuretype);[System.Obsolete("DestroyStructure(IntPtr, Type) may be unavailable in future releases. Instead, use DestroyStructure<T>(IntPtr). For more info, go to http://go.microsoft.com/fwlink/?LinkID=296520")]
[System.Security.SecurityCritical]
public static void DestroyStructure(IntPtr ptr, Type structuretype);public static void DestroyStructure(IntPtr ptr, Type structuretype);[System.Security.SecurityCritical]
public static void DestroyStructure(IntPtr ptr, Type structuretype);[System.Runtime.InteropServices.ComVisible(true)]
public static void DestroyStructure(IntPtr ptr, Type structuretype);[System.Security.SecurityCritical]
[System.Runtime.InteropServices.ComVisible(true)]
public static void DestroyStructure(IntPtr ptr, Type structuretype);[<System.Obsolete("DestroyStructure(IntPtr, Type) may be unavailable in future releases. Instead, use DestroyStructure<T>(IntPtr). For more info, go to http://go.microsoft.com/fwlink/?LinkID=296520")>]
[<System.Security.SecurityCritical>]
static member DestroyStructure : nativeint * Type -> unitstatic member DestroyStructure : nativeint * Type -> unit[<System.Security.SecurityCritical>]
static member DestroyStructure : nativeint * Type -> unit[<System.Runtime.InteropServices.ComVisible(true)>]
static member DestroyStructure : nativeint * Type -> unit[<System.Security.SecurityCritical>]
[<System.Runtime.InteropServices.ComVisible(true)>]
static member DestroyStructure : nativeint * Type -> unitPublic Shared Sub DestroyStructure (ptr As IntPtr, structuretype As Type)Parameter
- ptr
-
IntPtr
nativeint
Ein Zeiger auf einen nicht verwalteten Speicherblock.
- structuretype
- Type
Typ einer formatierten Klasse. Damit werden die Layoutinformationen bereitgestellt, die zum Löschen des Puffers im ptr-Parameter benötigt werden.
- Attribute
Ausnahmen
structureType weist ein automatisch angelegtes Layout auf. Verwenden Sie stattdessen sequenzielles oder explizites Layout.
Hinweise
Sie können diese Methode verwenden, um Verweistypfelder, z. B. Zeichenfolgen, einer nicht verwalteten Struktur freizugeben. Im Gegensatz zu ihren Feldern kann eine Struktur ein Werttyp oder ein Verweistyp sein. Werttypstrukturen, die Werttypfelder (alle blittierbar) enthalten, weisen keine Verweise auf, deren Arbeitsspeicher freigegeben werden muss. Die Marshal.StructureToPtr -Methode verwendet diese Methode, um Speicherverluste bei der Wiederverwendung von Speicher zu verhindern, der von einer -Struktur belegt wird.
DestroyStructure ruft die COM-SysFreeString-Funktion auf, die wiederum eine zugeordnete Zeichenfolge freigibt.
Zusätzlich zu DestroyStructurestellt die Marshal -Klasse zwei weitere Methoden zur Speicheraufteilung bereit: FreeCoTaskMem und FreeHGlobal.
Weitere Informationen
Gilt für:
.NET 9 und andere Versionen
| Produkt | Versionen (Veraltet) |
|---|---|
| .NET | Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9 (Core 1.0) |
| .NET Framework | 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
| .NET Standard | 1.1, 2.0, 2.1 (1.2, 1.3, 1.4, 1.5, 1.6) |
| UWP | (10.0) |
- Quelle:
- Marshal.cs
- Quelle:
- Marshal.cs
- Quelle:
- Marshal.cs
Gibt alle Unterstrukturen eines angegebenen Typs frei, auf die der angegebene nicht verwaltete Speicherblock zeigt.
public:
generic <typename T>
static void DestroyStructure(IntPtr ptr);[System.Security.SecurityCritical]
public static void DestroyStructure<T>(IntPtr ptr);public static void DestroyStructure<T>(IntPtr ptr);[<System.Security.SecurityCritical>]
static member DestroyStructure : nativeint -> unitstatic member DestroyStructure : nativeint -> unitPublic Shared Sub DestroyStructure(Of T) (ptr As IntPtr)Typparameter
- T
Der Typ der formatierten Struktur. Damit werden die Layoutinformationen bereitgestellt, die zum Löschen des Puffers im ptr-Parameter benötigt werden.
Parameter
- ptr
-
IntPtr
nativeint
Ein Zeiger auf einen nicht verwalteten Speicherblock.
- Attribute
Ausnahmen
T weist ein automatisch angelegtes Layout auf. Verwenden Sie stattdessen sequenzielles oder explizites Layout.
Hinweise
Sie können diese Methode verwenden, um Verweistypfelder wie Zeichenfolgen einer nicht verwalteten Struktur freizugeben. Im Gegensatz zu ihren Feldern kann eine Struktur ein Werttyp oder ein Verweistyp sein. Werttypstrukturen, die Wertetypfelder (alle blittierbar) enthalten, weisen keine Verweise auf, deren Arbeitsspeicher freigegeben werden muss. Die Marshal.StructureToPtr -Methode verwendet diese Methode, um Speicherverluste bei der Wiederverwendung von Speicher zu verhindern, der von einer -Struktur belegt wird.
DestroyStructure ruft die COM-SysFreeString-Funktion auf, die wiederum eine zugeordnete Zeichenfolge freigibt.
Gilt für:
.NET 9 und andere Versionen
| Produkt | Versionen |
|---|---|
| .NET | Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9 |
| .NET Framework | 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
| .NET Standard | 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1 |
| UWP | 10.0 |
Feedback zu .NET
.NET ist ein Open Source-Projekt. Wählen Sie einen Link aus, um Feedback zu geben: