Marshal Class
Assembly: mscorlib (in mscorlib.dll)
The static methods defined on the Marshal class are essential to working with unmanaged code. Most methods defined in this class are typically used by developers who need to provide a bridge between the managed and unmanaged programming models. For example, the StringToHGlobalAnsi method copies ANSI characters from a specified string (in the managed heap) to a buffer in the unmanaged heap. It also allocates the target heap of the right size.
The common language runtime provides specific marshaling capabilities. For details on marshaling behavior, see Interop Marshaling.
The following code example shows how to use various methods defined by the Marshal class.
Imports System Imports System.Text Imports System.Runtime.InteropServices Imports System.Security.Permissions Public Structure Point Public x, y As Int32 End Structure Public NotInheritable Class App <SecurityPermission(SecurityAction.LinkDemand, Unrestricted:=True)> _ Shared Sub Main() ' Demonstrate the use of public static fields of the Marshal class. Console.WriteLine("SystemDefaultCharSize={0}, SystemMaxDBCSCharSize={1}", Marshal.SystemDefaultCharSize, Marshal.SystemMaxDBCSCharSize) ' Demonstrate the use of the SizeOf method of the Marshal class. Console.WriteLine("Number of bytes needed by a Point object: {0}", Marshal.SizeOf(GetType(Point))) Dim p As New Point() Console.WriteLine("Number of bytes needed by a Point object: {0}", Marshal.SizeOf(p)) ' Demonstrate how to call GlobalAlloc and ' GlobalFree using the Marshal class. Dim hglobal As IntPtr = Marshal.AllocHGlobal(100) Marshal.FreeHGlobal(hglobal) ' Demonstrate how to use the Marshal class to get the Win32 error ' code when a Win32 method fails. Dim f As [Boolean] = CloseHandle(New IntPtr(-1)) If Not f Then Console.WriteLine("CloseHandle call failed with an error code of: {0}", Marshal.GetLastWin32Error()) End If End Sub ' This is a platform invoke prototype. SetLastError is true, which allows ' the GetLastWin32Error method of the Marshal class to work correctly. <DllImport("Kernel32", ExactSpelling:=True, SetLastError:=True)> _ Shared Function CloseHandle(ByVal h As IntPtr) As [Boolean] End Function End Class ' This code produces the following output. ' ' SystemDefaultCharSize=2, SystemMaxDBCSCharSize=1 ' Number of bytes needed by a Point object: 8 ' Number of bytes needed by a Point object: 8 ' CloseHandle call failed with an error code of: 6
Windows 98, Windows Server 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.