Marshal.ReadInt64 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 64-Bit-Ganzzahl mit Vorzeichen aus dem nicht verwalteten Speicher. Das Lesen aus nicht ausgerichteten Speicheradressen wird unterstützt.
Überlädt
ReadInt64(IntPtr) |
Liest eine 64-Bit-Ganzzahl mit Vorzeichen aus dem nicht verwalteten Speicher. |
ReadInt64(IntPtr, Int32) |
Liest eine 64-Bit-Ganzzahl mit Vorzeichen an einem angegebenen Offset aus dem nicht verwalteten Arbeitsspeicher. |
ReadInt64(Object, Int32) |
Veraltet.
Liest eine 64-Bit-Ganzzahl mit Vorzeichen an einem angegebenen Offset aus dem nicht verwalteten Arbeitsspeicher. |
ReadInt64(IntPtr)
- Quelle:
- Marshal.cs
- Quelle:
- Marshal.cs
- Quelle:
- Marshal.cs
Liest eine 64-Bit-Ganzzahl mit Vorzeichen aus dem nicht verwalteten Speicher.
public:
static long ReadInt64(IntPtr ptr);
[System.Security.SecurityCritical]
public static long ReadInt64 (IntPtr ptr);
public static long ReadInt64 (IntPtr ptr);
[<System.Security.SecurityCritical>]
static member ReadInt64 : nativeint -> int64
static member ReadInt64 : nativeint -> int64
Public Shared Function ReadInt64 (ptr As IntPtr) As Long
Parameter
- ptr
-
IntPtr
nativeint
Die Adresse im nicht verwalteten Speicher, an der gelesen werden soll.
Gibt zurück
Die 64-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 ReadInt64 Methoden und WriteInt64 lesen und in ein nicht verwaltetes Array schreiben.
static void ReadWriteInt64()
{
// Allocate unmanaged memory.
int elementSize = 8;
IntPtr unmanagedArray = Marshal.AllocHGlobal(10 * elementSize);
// Set the 10 elements of the C-style unmanagedArray
for (int i = 0; i < 10; i++)
{
Marshal.WriteInt64(unmanagedArray, i * elementSize, ((Int64)(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.ReadInt64(unmanagedArray, i * elementSize));
}
Marshal.FreeHGlobal(unmanagedArray);
Console.WriteLine("Done. Press Enter to continue.");
Console.ReadLine();
}
Sub ReadWriteInt64()
' Allocate unmanaged memory.
Dim elementSize As Integer = 8
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.WriteInt64(unmanagedArray, i * elementSize, CType(i + 1, Int64))
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.ReadInt64(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 ReadInt64 -Methode verwenden, um den Wert einer nicht verwalteten __int64
Variablen zu lesen.
using namespace System;
using namespace System::Runtime::InteropServices;
void main()
{
// Create an unmanaged __int64.
__int64 myVal = 42;
// Read the value as a managed Int64.
Int64 ^ myManagedVal = Marshal::ReadInt64((IntPtr) &myVal);
// Display the value to the console.
Console::WriteLine(myManagedVal);
}
Hinweise
ReadInt64 weist einen impliziten Offset von 0 auf. Diese Methode ermöglicht die direkte Interaktion mit einem nicht verwalteten Array im C-Stil Int64
, 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:
ReadInt64(IntPtr, Int32)
- Quelle:
- Marshal.cs
- Quelle:
- Marshal.cs
- Quelle:
- Marshal.cs
Liest eine 64-Bit-Ganzzahl mit Vorzeichen an einem angegebenen Offset aus dem nicht verwalteten Arbeitsspeicher.
public:
static long ReadInt64(IntPtr ptr, int ofs);
[System.Security.SecurityCritical]
public static long ReadInt64 (IntPtr ptr, int ofs);
public static long ReadInt64 (IntPtr ptr, int ofs);
[<System.Security.SecurityCritical>]
static member ReadInt64 : nativeint * int -> int64
static member ReadInt64 : nativeint * int -> int64
Public Shared Function ReadInt64 (ptr As IntPtr, ofs As Integer) As Long
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 64-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.
Beispiele
Im folgenden Beispiel wird veranschaulicht, wie Sie mit den ReadInt64 Methoden und WriteInt64 lesen und in ein nicht verwaltetes Array schreiben.
static void ReadWriteInt64()
{
// Allocate unmanaged memory.
int elementSize = 8;
IntPtr unmanagedArray = Marshal.AllocHGlobal(10 * elementSize);
// Set the 10 elements of the C-style unmanagedArray
for (int i = 0; i < 10; i++)
{
Marshal.WriteInt64(unmanagedArray, i * elementSize, ((Int64)(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.ReadInt64(unmanagedArray, i * elementSize));
}
Marshal.FreeHGlobal(unmanagedArray);
Console.WriteLine("Done. Press Enter to continue.");
Console.ReadLine();
}
Sub ReadWriteInt64()
' Allocate unmanaged memory.
Dim elementSize As Integer = 8
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.WriteInt64(unmanagedArray, i * elementSize, CType(i + 1, Int64))
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.ReadInt64(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 ReadInt64 -Methode verwenden, um den Wert einer nicht verwalteten __int64
Variablen zu lesen.
using namespace System;
using namespace System::Runtime::InteropServices;
void main()
{
// Create an unmanaged __int64 pointer.
__int64 * myVal;
__int64 tmp = 42;
// Initialize it to another value.
myVal = &tmp;
// Read value as a managed Int64.
Int64 ^ myManagedVal = Marshal::ReadInt64((IntPtr) myVal, 0);
// Display the value to the console.
Console::WriteLine(myManagedVal);
}
Hinweise
ReadInt64 ermöglicht die direkte Interaktion mit einem nicht verwalteten 64-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:
ReadInt64(Object, Int32)
- Quelle:
- Marshal.CoreCLR.cs
- Quelle:
- Marshal.CoreCLR.cs
- Quelle:
- Marshal.CoreCLR.cs
Achtung
ReadInt64(Object, Int32) may be unavailable in future releases.
Liest eine 64-Bit-Ganzzahl mit Vorzeichen an einem angegebenen Offset aus dem nicht verwalteten Arbeitsspeicher.
public:
static long ReadInt64(System::Object ^ ptr, int ofs);
[System.Obsolete("ReadInt64(Object, Int32) may be unavailable in future releases.")]
[System.Security.SecurityCritical]
public static long ReadInt64 (object ptr, int ofs);
[System.Obsolete("ReadInt64(Object, Int32) may be unavailable in future releases.")]
public static long ReadInt64 (object ptr, int ofs);
public static long ReadInt64 (object ptr, int ofs);
[System.Security.SecurityCritical]
public static long ReadInt64 (object ptr, int ofs);
[<System.Obsolete("ReadInt64(Object, Int32) may be unavailable in future releases.")>]
[<System.Security.SecurityCritical>]
static member ReadInt64 : obj * int -> int64
[<System.Obsolete("ReadInt64(Object, Int32) may be unavailable in future releases.")>]
static member ReadInt64 : obj * int -> int64
static member ReadInt64 : obj * int -> int64
[<System.Security.SecurityCritical>]
static member ReadInt64 : obj * int -> int64
Public Shared Function ReadInt64 (ptr As Object, ofs As Integer) As Long
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 64-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
ReadInt64 ermöglicht die direkte Interaktion mit einem nicht verwalteten 64-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.