Marshal.ReadByte Methode

Definition

Namespace:

System.Runtime.InteropServices

Assembly:

System.Runtime.InteropServices.dll

Liest ein einzelnes Byte aus dem nicht verwalteten Speicher. Das Lesen aus nicht ausgerichteten Speicheradressen wird unterstützt.

Überlädt

ReadByte(IntPtr, Int32)	Liest ein einzelnes Byte an einem angegebenen Offset (oder Index) aus dem nicht verwalteten Speicher.
ReadByte(Object, Int32)	Veraltet. Liest ein einzelnes Byte an einem angegebenen Offset (oder Index) aus dem nicht verwalteten Speicher.
ReadByte(IntPtr)	Liest ein einzelnes Byte aus dem nicht verwalteten Speicher.

ReadByte(IntPtr, Int32)

Quelle:

Marshal.cs

Liest ein einzelnes Byte an einem angegebenen Offset (oder Index) aus dem nicht verwalteten Speicher.

public:
 static System::Byte ReadByte(IntPtr ptr, int ofs);

public static byte ReadByte (IntPtr ptr, int ofs);

static member ReadByte : nativeint * int -> byte

Public Shared Function ReadByte (ptr As IntPtr, ofs As Integer) As Byte

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

Byte

Das aus dem nicht verwalteten Arbeitsspeicher am angegebenen Offset gelesene Byte.

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

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

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

    Marshal.FreeHGlobal(unmanagedArray);

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

Sub ReadWriteByte()
    ' Allocate unmanaged memory. 
    Dim elementSize As Integer = 1
    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.WriteByte(unmanagedArray, i * elementSize, CType(i + 1, Byte))
    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.ReadByte(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 die ReadByte -Methode verwendet wird, um den Wert eines nicht verwalteten Zeichens zu lesen.

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



void main()
{
    // Create an unmanaged byte.
    const char * myString = "bB";

    // Read the second character of the c string as a managed byte.
        Byte ^ myManagedByte = Marshal::ReadByte((IntPtr) (char *) myString, 1);

    // Display the byte to the console.
    Console::WriteLine(myManagedByte);
}

Hinweise

ReadByte 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 Lesen der Elementwerte entfällt.

Das Lesen aus nicht ausgerichteten Speicheradressen wird unterstützt.

Weitere Informationen

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

ReadByte(Object, Int32)

Quelle:

Marshal.CoreCLR.cs

Achtung

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

Liest ein einzelnes Byte an einem angegebenen Offset (oder Index) aus dem nicht verwalteten Speicher.

public:
 static System::Byte ReadByte(System::Object ^ ptr, int ofs);

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

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

Public Shared Function ReadByte (ptr As Object, ofs As Integer) As Byte

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

Byte

Das aus dem nicht verwalteten Arbeitsspeicher am angegebenen Offset gelesene Byte.

Attribute

ObsoleteAttribute

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

ReadByte 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 Lesen der Elementwerte entfällt.

Das Lesen aus nicht ausgerichteten Speicheradressen wird unterstützt.

Weitere Informationen

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

ReadByte(IntPtr)

Quelle:

Marshal.cs

Liest ein einzelnes Byte aus dem nicht verwalteten Speicher.

public:
 static System::Byte ReadByte(IntPtr ptr);

public static byte ReadByte (IntPtr ptr);

static member ReadByte : nativeint -> byte

Public Shared Function ReadByte (ptr As IntPtr) As Byte

Parameter

ptr

IntPtr

nativeint

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

Gibt zurück

Byte

Das aus dem nicht verwalteten Arbeitsspeicher gelesene Byte.

Ausnahmen

AccessViolationException

ptr ist kein erkanntes Format.

- oder -

ptr ist null.

- oder -

ptr ist ungültig.

Beispiele

Im folgenden Beispiel wird ein Block mit nicht verwaltetem Arbeitsspeicher erstellt, ein Byte in den nicht verwalteten Arbeitsspeicher geschrieben, das Byte aus dem nicht verwalteten Speicher zurückgelesen und anschließend der nicht verwaltete Arbeitsspeicher gelöscht.

using System;
using System.Runtime.InteropServices;

 class Example
 {
     static void Main(string[] args)
     {
          // Allocate 1 byte of unmanaged memory.
          IntPtr hGlobal = Marshal.AllocHGlobal(1);

          // Create a new byte.
          byte b = 1;
          Console.WriteLine("Byte written to unmanaged memory: " + b);

          // Write the byte to unmanaged memory.
          Marshal.WriteByte(hGlobal, b);

          // Read byte from unmanaged memory.
          byte c = Marshal.ReadByte(hGlobal);
          Console.WriteLine("Byte read from unmanaged memory: " + c);

          // Free the unmanaged memory.
          Marshal.FreeHGlobal(hGlobal);
          Console.WriteLine("Unmanaged memory was disposed.");
     }
}

Imports System.Runtime.InteropServices

Module Example
    Sub Main()
         ' Allocate 1 byte of unmanaged memory.
         Dim hGlobal As IntPtr = Marshal.AllocHGlobal(1)
         
         ' Create a new byte.
         Dim b As Byte = 1
         
         Console.WriteLine("Byte written to unmanaged memory: {0}", b)
         
         ' Write the byte to unmanaged memory.
         Marshal.WriteByte(hGlobal, b)
         
         ' Read byte from unmanaged memory.
         Dim c As Byte = Marshal.ReadByte(hGlobal)
         Console.WriteLine("Byte read from unmanaged memory: {0}", c)
         
         ' Free the unmanaged memory.
         Marshal.FreeHGlobal(hGlobal)
         Console.WriteLine("Unmanaged memory was disposed.")
    End Sub
End Module

Im folgenden Beispiel wird veranschaulicht, wie die ReadByte -Methode verwendet wird, um den Wert eines nicht verwalteten Zeichens zu lesen.

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



void main()
{
    // Create an unmanaged byte.
    const char * myString = "b";

    // Read the c string as a managed byte.
        Byte ^ myManagedByte = Marshal::ReadByte((IntPtr) (char *) myString);

    // Display the byte to the console.
    Console::WriteLine(myManagedByte);
}

Hinweise

ReadByte weist einen impliziten Offset von 0 auf. Diese Methode 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 Lesen der Elementwerte entfällt.

Das Lesen aus nicht ausgerichteten Speicheradressen wird unterstützt.

Weitere Informationen

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