Marshal.ReadInt32 Methode

  • Referenz

Definition

Namespace:
System.Runtime.InteropServices
Assembly:
System.Runtime.InteropServices.dll
Assembly:
mscorlib.dll
Assembly:
netstandard.dll

Liest eine 32-Bit-Ganzzahl mit Vorzeichen aus dem nicht verwalteten Speicher. Das Lesen aus nicht ausgerichteten Speicheradressen wird unterstützt.

Überlädt

ReadInt32(IntPtr)

Liest eine 32-Bit-Ganzzahl mit Vorzeichen aus dem nicht verwalteten Speicher.
ReadInt32(IntPtr, Int32)

Liest eine 32-Bit-Ganzzahl mit Vorzeichen an einem angegebenen Offset aus dem nicht verwalteten Arbeitsspeicher.
ReadInt32(Object, Int32)
Veraltet.

Liest eine 32-Bit-Ganzzahl mit Vorzeichen an einem angegebenen Offset aus dem nicht verwalteten Arbeitsspeicher.

ReadInt32(IntPtr)

Quelle:
Marshal.cs
Quelle:
Marshal.cs
Quelle:
Marshal.cs

Liest eine 32-Bit-Ganzzahl mit Vorzeichen aus dem nicht verwalteten Speicher.

public:
 static int ReadInt32(IntPtr ptr);
[System.Security.SecurityCritical]
public static int ReadInt32 (IntPtr ptr);
public static int ReadInt32 (IntPtr ptr);
[<System.Security.SecurityCritical>]
static member ReadInt32 : nativeint -> int
static member ReadInt32 : nativeint -> int
Public Shared Function ReadInt32 (ptr As IntPtr) As Integer

Parameter

ptr
IntPtr

nativeint

Die Adresse im nicht verwalteten Speicher, an der gelesen werden soll.

Gibt zurück

Int32

Die 32-Bit-Ganzzahl mit Vorzeichen, die aus dem nicht verwalteten Speicher gelesen wurde.

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 ReadInt32 Methoden und WriteInt32 lesen und in ein nicht verwaltetes Array schreiben.

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

    // Set the 10 elements of the C-style unmanagedArray
    for (int i = 0; i < 10; i++)
    {
        Marshal.WriteInt32(unmanagedArray, i * elementSize, ((Int32)(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.ReadInt32(unmanagedArray, i * elementSize));
    }

    Marshal.FreeHGlobal(unmanagedArray);

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

Sub ReadWriteInt32()
    ' Allocate unmanaged memory. 
    Dim elementSize As Integer = 4
    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.WriteInt32(unmanagedArray, i * elementSize, CType(i + 1, Int32))
    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.ReadInt32(unmanagedArray, i * elementSize))
    Next i

    Marshal.FreeHGlobal(unmanagedArray)

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

Im folgenden Beispiel wird veranschaulicht, wie Sie die ReadInt32 -Methode verwenden, um den Wert einer nicht verwalteten int Variablen zu lesen.

using namespace System;
using namespace System::Runtime::InteropServices;



void main()
{
    // Create an unmanaged integer.
    int myVal = 42;

    // Read the int as a managed Int32.
        Int32 ^ myManagedVal = Marshal::ReadInt32((IntPtr) &myVal);

    // Display the value to the console.
    Console::WriteLine(myManagedVal);
}

Hinweise

ReadInt32 weist einen impliziten Offset von 0 auf. Diese Methode ermöglicht die direkte Interaktion mit einem nicht verwalteten Array im C-Stil Int32 , wodurch das Kopieren eines gesamten nicht verwalteten Arrays (mit Marshal.Copy) in ein separates verwaltetes Array vor dem Lesen der Elementwerte entfällt.

Das Lesen aus nicht ausgerichteten Speicheradressen wird unterstützt.

Weitere Informationen

Gilt für:

ReadInt32(IntPtr, Int32)

Quelle:
Marshal.cs
Quelle:
Marshal.cs
Quelle:
Marshal.cs

Liest eine 32-Bit-Ganzzahl mit Vorzeichen an einem angegebenen Offset aus dem nicht verwalteten Arbeitsspeicher.

public:
 static int ReadInt32(IntPtr ptr, int ofs);
[System.Security.SecurityCritical]
public static int ReadInt32 (IntPtr ptr, int ofs);
public static int ReadInt32 (IntPtr ptr, int ofs);
[<System.Security.SecurityCritical>]
static member ReadInt32 : nativeint * int -> int
static member ReadInt32 : nativeint * int -> int
Public Shared Function ReadInt32 (ptr As IntPtr, ofs As Integer) As Integer

Parameter

ptr
IntPtr

nativeint

Die Basisadresse im nicht verwalteten Speicher, an der gelesen werden soll.

ofs
Int32

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

Gibt zurück

Int32

Die 32-Bit-Ganzzahl mit Vorzeichen, die aus dem nicht verwalteten Speicher gelesen wurde.

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 ReadInt32 Methoden und WriteInt32 lesen und in ein nicht verwaltetes Array schreiben.

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

    // Set the 10 elements of the C-style unmanagedArray
    for (int i = 0; i < 10; i++)
    {
        Marshal.WriteInt32(unmanagedArray, i * elementSize, ((Int32)(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.ReadInt32(unmanagedArray, i * elementSize));
    }

    Marshal.FreeHGlobal(unmanagedArray);

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

Sub ReadWriteInt32()
    ' Allocate unmanaged memory. 
    Dim elementSize As Integer = 4
    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.WriteInt32(unmanagedArray, i * elementSize, CType(i + 1, Int32))
    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.ReadInt32(unmanagedArray, i * elementSize))
    Next i

    Marshal.FreeHGlobal(unmanagedArray)

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

Im folgenden Beispiel wird veranschaulicht, wie Sie die ReadInt32 -Methode verwenden, um den Wert einer nicht verwalteten int Variablen zu lesen.

using namespace System;
using namespace System::Runtime::InteropServices;



void main()
{
    // Create an unmanaged int pointer.
    int * myVal;
    int tmp = 42;
    // Initialize it to another value.
    myVal = &tmp;

    // Read value as a managed Int32.
    Int32 ^ myManagedVal = Marshal::ReadInt32((IntPtr) myVal, 0);

    // Display the value to the console.
    Console::WriteLine(myManagedVal);
}

Hinweise

ReadInt32 ermöglicht die direkte Interaktion mit einem nicht verwalteten 32-Bit-Array mit Vorzeichen, wodurch das Kopieren eines gesamten nicht verwalteten Arrays (mit Marshal.Copy) in ein separates verwaltetes Array vor dem Lesen der Elementwerte entfällt.

Das Lesen aus nicht ausgerichteten Speicheradressen wird unterstützt.

Weitere Informationen

Gilt für:

ReadInt32(Object, Int32)

Quelle:
Marshal.CoreCLR.cs
Quelle:
Marshal.CoreCLR.cs
Quelle:
Marshal.CoreCLR.cs

Achtung

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

Liest eine 32-Bit-Ganzzahl mit Vorzeichen an einem angegebenen Offset aus dem nicht verwalteten Arbeitsspeicher.

public:
 static int ReadInt32(System::Object ^ ptr, int ofs);
[System.Obsolete("ReadInt32(Object, Int32) may be unavailable in future releases.")]
[System.Security.SecurityCritical]
public static int ReadInt32 (object ptr, int ofs);
[System.Obsolete("ReadInt32(Object, Int32) may be unavailable in future releases.")]
public static int ReadInt32 (object ptr, int ofs);
public static int ReadInt32 (object ptr, int ofs);
[System.Security.SecurityCritical]
public static int ReadInt32 (object ptr, int ofs);
[<System.Obsolete("ReadInt32(Object, Int32) may be unavailable in future releases.")>]
[<System.Security.SecurityCritical>]
static member ReadInt32 : obj * int -> int
[<System.Obsolete("ReadInt32(Object, Int32) may be unavailable in future releases.")>]
static member ReadInt32 : obj * int -> int
static member ReadInt32 : obj * int -> int
[<System.Security.SecurityCritical>]
static member ReadInt32 : obj * int -> int
Public Shared Function ReadInt32 (ptr As Object, ofs As Integer) As Integer

Parameter

ptr
Object

Die Basisadresse im nicht verwalteten Speicher des Quellobjekts.

ofs
Int32

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

Gibt zurück

Int32

Die 32-Bit-Ganzzahl mit Vorzeichen, die am angegebenen Offset aus dem nicht verwalteten Arbeitsspeicher gelesen wurde.

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

ReadInt32 ermöglicht die direkte Interaktion mit einem nicht verwalteten 32-Bit-Array mit Vorzeichen, wodurch das Kopieren eines gesamten nicht verwalteten Arrays (mit Marshal.Copy) in ein separates verwaltetes Array vor dem Lesen der Elementwerte entfällt.

Das Lesen aus nicht ausgerichteten Speicheradressen wird unterstützt.

Weitere Informationen

Gilt für: