Marshal.WriteIntPtr Methode

Referenz

Definition

Namespace:: System.Runtime.InteropServices

Assemblys:: mscorlib.dll, System.Runtime.InteropServices.dll

Assemblys:: netstandard.dll, System.Runtime.InteropServices.dll

Assembly:: System.Runtime.InteropServices.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

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.

Schreibt einen Ganzzahlwert von prozessoreigener Größe in den nicht verwalteten Speicher. 32-Bit-Ganzzahlen werden auf 32-Bit-Systemen geschrieben, und 64-Bit-Ganzzahlen werden auf 64-Bit-Systemen geschrieben. Das Schreiben in nicht ausgerichtete Speicheradressen wird unterstützt.

Überlädt

WriteIntPtr(IntPtr, IntPtr)	Schreibt einen Ganzzahlwert von prozessoreigener Größe in den nicht verwalteten Speicher.
WriteIntPtr(IntPtr, Int32, IntPtr)	Schreibt einen Ganzzahlwert von prozessoreigener Größe am angegebenen Offset in den nicht verwalteten Speicher.
WriteIntPtr(Object, Int32, IntPtr)	Veraltet. Schreibt einen Ganzzahlwert von prozessoreigener Größe in den nicht verwalteten Speicher.

WriteIntPtr(IntPtr, IntPtr)

Quelle:: Marshal.cs

Quelle:: Marshal.cs

Quelle:: Marshal.cs

Schreibt einen Ganzzahlwert von prozessoreigener Größe in den nicht verwalteten Speicher.

public:
 static void WriteIntPtr(IntPtr ptr, IntPtr val);

[System.Security.SecurityCritical]
public static void WriteIntPtr(IntPtr ptr, IntPtr val);

public static void WriteIntPtr(IntPtr ptr, IntPtr val);

[<System.Security.SecurityCritical>]
static member WriteIntPtr : nativeint * nativeint -> unit

static member WriteIntPtr : nativeint * nativeint -> unit

Public Shared Sub WriteIntPtr (ptr As IntPtr, val As IntPtr)

Parameter

ptr: IntPtr

Die Adresse im nicht verwalteten Speicher, in die geschrieben werden soll.

val: IntPtr

Der zu schreibende Wert.

Attribute: SecurityCriticalAttribute

Ausnahmen

AccessViolationException

ptr ist kein erkanntes Format.

- oder -

ptr ist null.

- oder -

ptr ist ungültig.

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie sie mit den ReadIntPtr WriteIntPtr Methoden und lesen und in ein nicht verwaltetes Array schreiben.

static void ReadWriteIntPtr()
{
    // Allocate unmanaged memory. 
    int elementSize = Marshal.SizeOf(typeof(IntPtr));
    IntPtr unmanagedArray = Marshal.AllocHGlobal(10 * elementSize);

    // Set the 10 elements of the C-style unmanagedArray
    for (int i = 0; i < 10; i++)
    {
        Marshal.WriteIntPtr(unmanagedArray, i * elementSize, ((IntPtr)(i + 1)));
    }
    Console.WriteLine("Unmanaged memory written.");

    Console.WriteLine("Reading unmanaged memory:");
    // Print the 10 elements of the C-style unmanagedArray
    for (int i = 0; i < 10; i++)
    {
        Console.WriteLine(Marshal.ReadIntPtr(unmanagedArray, i * elementSize));
    }

    Marshal.FreeHGlobal(unmanagedArray);

    Console.WriteLine("Done. Press Enter to continue.");
    Console.ReadLine();
}

Sub ReadWriteIntPtr()
    ' Allocate unmanaged memory.
    Dim elementSize As Integer = Marshal.SizeOf(GetType(IntPtr))
    Dim unmanagedArray As IntPtr = Marshal.AllocHGlobal(10 * elementSize)

    ' Set the 10 elements of the C-style unmanagedArray
    For i As Integer = 0 To 9
        Marshal.WriteIntPtr(unmanagedArray, i * elementSize, CType(i + 1, IntPtr))
    Next i
    Console.WriteLine("Unmanaged memory written.")

    Console.WriteLine("Reading unmanaged memory:")
    ' Print the 10 elements of the C-style unmanagedArray
    For i As Integer = 0 To 9
        Console.WriteLine(Marshal.ReadIntPtr(unmanagedArray, i * elementSize))
    Next i

    Marshal.FreeHGlobal(unmanagedArray)

    Console.WriteLine("Done. Press Enter to continue.")
    Console.ReadLine()
End Sub

Hinweise

WriteIntPtr ermöglicht die direkte Interaktion mit einem nicht verwalteten Array im C-Stil IntPtr , wodurch der Aufwand für das Kopieren eines gesamten nicht verwalteten Arrays (mit Marshal.Copy) in ein separates verwaltetes Array vor dem Festlegen der Elementwerte entfällt.

Das Schreiben in nicht ausgerichtete Speicheradressen wird unterstützt.

Weitere Informationen

Copy(Int32[], Int32, IntPtr, Int32)

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	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, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0

WriteIntPtr(IntPtr, Int32, IntPtr)

Quelle:: Marshal.cs

Quelle:: Marshal.cs

Quelle:: Marshal.cs

Schreibt einen Ganzzahlwert von prozessoreigener Größe am angegebenen Offset in den nicht verwalteten Speicher.

public:
 static void WriteIntPtr(IntPtr ptr, int ofs, IntPtr val);

[System.Security.SecurityCritical]
public static void WriteIntPtr(IntPtr ptr, int ofs, IntPtr val);

public static void WriteIntPtr(IntPtr ptr, int ofs, IntPtr val);

[<System.Security.SecurityCritical>]
static member WriteIntPtr : nativeint * int * nativeint -> unit

static member WriteIntPtr : nativeint * int * nativeint -> unit

Public Shared Sub WriteIntPtr (ptr As IntPtr, ofs As Integer, val As IntPtr)

Parameter

ptr: IntPtr

Die Basisadresse im nicht verwalteten Speicher, in die geschrieben werden soll.

ofs: Int32

Ein zusätzlicher Byteoffset, der dem ptr-Parameter vor dem Schreiben hinzugefügt wird.

val: IntPtr

Der zu schreibende Wert.

Attribute: SecurityCriticalAttribute

Ausnahmen

AccessViolationException

Die Basisadresse (ptr) und das Offsetbyte (ofs) erzeugen NULL oder eine ungültige Adresse.

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie sie mit den ReadIntPtr WriteIntPtr Methoden und lesen und in ein nicht verwaltetes Array schreiben.

static void ReadWriteIntPtr()
{
    // Allocate unmanaged memory. 
    int elementSize = Marshal.SizeOf(typeof(IntPtr));
    IntPtr unmanagedArray = Marshal.AllocHGlobal(10 * elementSize);

    // Set the 10 elements of the C-style unmanagedArray
    for (int i = 0; i < 10; i++)
    {
        Marshal.WriteIntPtr(unmanagedArray, i * elementSize, ((IntPtr)(i + 1)));
    }
    Console.WriteLine("Unmanaged memory written.");

    Console.WriteLine("Reading unmanaged memory:");
    // Print the 10 elements of the C-style unmanagedArray
    for (int i = 0; i < 10; i++)
    {
        Console.WriteLine(Marshal.ReadIntPtr(unmanagedArray, i * elementSize));
    }

    Marshal.FreeHGlobal(unmanagedArray);

    Console.WriteLine("Done. Press Enter to continue.");
    Console.ReadLine();
}

Sub ReadWriteIntPtr()
    ' Allocate unmanaged memory.
    Dim elementSize As Integer = Marshal.SizeOf(GetType(IntPtr))
    Dim unmanagedArray As IntPtr = Marshal.AllocHGlobal(10 * elementSize)

    ' Set the 10 elements of the C-style unmanagedArray
    For i As Integer = 0 To 9
        Marshal.WriteIntPtr(unmanagedArray, i * elementSize, CType(i + 1, IntPtr))
    Next i
    Console.WriteLine("Unmanaged memory written.")

    Console.WriteLine("Reading unmanaged memory:")
    ' Print the 10 elements of the C-style unmanagedArray
    For i As Integer = 0 To 9
        Console.WriteLine(Marshal.ReadIntPtr(unmanagedArray, i * elementSize))
    Next i

    Marshal.FreeHGlobal(unmanagedArray)

    Console.WriteLine("Done. Press Enter to continue.")
    Console.ReadLine()
End Sub

Hinweise

Diese Methode schreibt eine 32-Bit-Ganzzahl auf 32-Bit-Systemen und eine 64-Bit-Ganzzahl auf 64-Bit-Systemen.

Das Schreiben in nicht ausgerichtete Speicheradressen wird unterstützt.

Weitere Informationen

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	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, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0

WriteIntPtr(Object, Int32, IntPtr)

Quelle:: Marshal.cs

Quelle:: Marshal.cs

Quelle:: Marshal.cs

Achtung

WriteIntPtr(Object, Int32, IntPtr) may be unavailable in future releases.

Schreibt einen Ganzzahlwert von prozessoreigener Größe in den nicht verwalteten Speicher.

public:
 static void WriteIntPtr(System::Object ^ ptr, int ofs, IntPtr val);

[System.Obsolete("WriteIntPtr(Object, Int32, IntPtr) may be unavailable in future releases.")]
[System.Security.SecurityCritical]
public static void WriteIntPtr(object ptr, int ofs, IntPtr val);

[System.Obsolete("WriteIntPtr(Object, Int32, IntPtr) may be unavailable in future releases.")]
public static void WriteIntPtr(object ptr, int ofs, IntPtr val);

public static void WriteIntPtr(object ptr, int ofs, IntPtr val);

[System.Security.SecurityCritical]
public static void WriteIntPtr(object ptr, int ofs, IntPtr val);

[<System.Obsolete("WriteIntPtr(Object, Int32, IntPtr) may be unavailable in future releases.")>]
[<System.Security.SecurityCritical>]
static member WriteIntPtr : obj * int * nativeint -> unit

[<System.Obsolete("WriteIntPtr(Object, Int32, IntPtr) may be unavailable in future releases.")>]
static member WriteIntPtr : obj * int * nativeint -> unit

static member WriteIntPtr : obj * int * nativeint -> unit

[<System.Security.SecurityCritical>]
static member WriteIntPtr : obj * int * nativeint -> unit

Public Shared Sub WriteIntPtr (ptr As Object, ofs As Integer, val As IntPtr)

Parameter

ptr: Object

Die Basisadresse im nicht verwalteten Speicher des Zielobjekts.

ofs: Int32

Ein zusätzlicher Byteoffset, der dem ptr-Parameter vor dem Schreiben hinzugefügt wird.

val: IntPtr

Der zu schreibende Wert.

Attribute: ObsoleteAttribute SecurityCriticalAttribute

Ausnahmen

AccessViolationException

Die Basisadresse (ptr) und das Offsetbyte (ofs) erzeugen NULL oder eine ungültige Adresse.

ArgumentException

ptr ist ein ArrayWithOffset-Objekt. Diese Methode akzeptiert keine ArrayWithOffset-Parameter.

Hinweise

WriteIntPtr ermöglicht die direkte Interaktion mit einem nicht verwalteten Bytearray im C-Stil, wodurch der Aufwand für das Kopieren eines gesamten nicht verwalteten Arrays (mit Marshal.Copy) in ein separates verwaltetes Array vor dem Festlegen der Elementwerte entfällt.

Das Schreiben in nicht ausgerichtete Speicheradressen wird unterstützt.

Weitere Informationen

Copy(Int32[], Int32, IntPtr, Int32)

Gilt für:

.NET 9 und andere Versionen

Produkt	Versionen (Veraltet)
.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	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 (4.7 (package-provided), 4.7.1 (package-provided), 4.7.2 (package-provided), 4.8 (package-provided))
.NET Standard	1.1, 2.0 (1.2, 1.3, 1.4, 1.5, 1.6, 2.1)
UWP	(10.0)

Freigeben über

Marshal.WriteIntPtr Methode

Definition

Überlädt

WriteIntPtr(IntPtr, IntPtr)

Parameter

Ausnahmen

Beispiele

Hinweise

Weitere Informationen

Gilt für:

WriteIntPtr(IntPtr, Int32, IntPtr)

Parameter

Ausnahmen

Beispiele

Hinweise

Weitere Informationen

Gilt für:

WriteIntPtr(Object, Int32, IntPtr)

Parameter

Ausnahmen

Hinweise

Weitere Informationen

Gilt für:

Zusätzliche Ressourcen