Marshal.ReadInt32 Methode
Definition
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.
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
Die 32-Bit-Ganzzahl mit Vorzeichen, die aus dem nicht verwalteten Speicher gelesen wurde.
- Attribute
Ausnahmen
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
Die 32-Bit-Ganzzahl mit Vorzeichen, die aus dem nicht verwalteten Speicher gelesen wurde.
- Attribute
Ausnahmen
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
Die 32-Bit-Ganzzahl mit Vorzeichen, die am angegebenen Offset aus dem nicht verwalteten Arbeitsspeicher gelesen wurde.
- Attribute
Ausnahmen
Die Basisadresse (ptr
) und das Offsetbyte (ofs
) erzeugen NULL oder eine ungültige Adresse.
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.