Marshal.ReadByte Methode

Definition

Namespace:

System.Runtime.InteropServices

Assembly:

System.Runtime.InteropServices.dll

Liest ein einzelnes Byte aus nicht verwaltetem Speicher. Das Lesen von nicht ausgerichteten Speicherspeicherorten wird unterstützt.

Überlädt

ReadByte(IntPtr, Int32)	Liest ein einzelnes Byte bei einem bestimmten Offset (oder Index) aus nicht verwaltetem Speicher.
ReadByte(Object, Int32)	Veraltet. Liest ein einzelnes Byte bei einem bestimmten Offset (oder Index) aus nicht verwaltetem Speicher.
ReadByte(IntPtr)	Liest ein einzelnes Byte aus nicht verwaltetem Speicher.

ReadByte(IntPtr, Int32)

Quelle:

Marshal.cs

Liest ein einzelnes Byte bei einem bestimmten Offset (oder Index) aus nicht verwaltetem 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, aus dem gelesen werden soll.

ofs

Int32

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

Gibt zurück

Byte

The byte read from unmanaged memory at the given offset.

Ausnahmen

AccessViolationException

Basisadresse (ptr) plus Offsetbyte (ofs) erzeugt eine NULL- oder ungültige Adresse.

Beispiele

Im folgenden Beispiel wird das Lesen und Schreiben in ein nicht verwaltetes Array mithilfe der methoden ReadByte und WriteByte veranschaulicht.

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 direkte Interaktion mit einem nicht verwalteten C-Bytearray, wodurch die Kosten für das Kopieren eines gesamten nicht verwalteten Arrays (unter Verwendung von Marshal.Copy) in ein separates verwaltetes Array vermieden werden, bevor die Elementwerte gelesen werden.

Das Lesen von nicht ausgerichteten Speicherspeicherorten 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 bei einem bestimmten Offset (oder Index) aus nicht verwaltetem 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 Byte-Offset, der vor dem Lesen zum ptr Parameter hinzugefügt wird.

Gibt zurück

Byte

The byte read from unmanaged memory at the given offset.

Attribute

ObsoleteAttribute

Ausnahmen

AccessViolationException

Basisadresse (ptr) plus Offsetbyte (ofs) erzeugt eine NULL- oder ungültige Adresse.

ArgumentException

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

Hinweise

ReadByte ermöglicht direkte Interaktion mit einem nicht verwalteten C-Bytearray, wodurch die Kosten für das Kopieren eines gesamten nicht verwalteten Arrays (unter Verwendung von Marshal.Copy) in ein separates verwaltetes Array vermieden werden, bevor die Elementwerte gelesen werden.

Das Lesen von nicht ausgerichteten Speicherspeicherorten wird unterstützt.

Weitere Informationen

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

ReadByte(IntPtr)

Quelle:

Marshal.cs

Liest ein einzelnes Byte aus nicht verwaltetem 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, aus dem gelesen werden soll.

Gibt zurück

Byte

Das Byte, das aus nicht verwalteten Arbeitsspeicher gelesen wird.

Ausnahmen

AccessViolationException

ptr ist kein erkanntes Format.

-oder-

ptr ist null.

-oder-

ptr ist ungültig.

Beispiele

Im folgenden Beispiel wird ein Block des nicht verwalteten Speichers erstellt, ein Byte in den nicht verwalteten Speicher geschrieben, das Byte aus nicht verwaltetem Speicher zurückgelesen und anschließend der nicht verwaltete Speicher 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 implizierten Offset von 0 auf. Diese Methode ermöglicht direkte Interaktion mit einem nicht verwalteten C-Bytearray, wodurch die Kosten für das Kopieren eines gesamten nicht verwalteten Arrays (mithilfe von Marshal.Copy) in ein separates verwaltetes Array vermieden werden, bevor die Elementwerte gelesen werden.

Das Lesen von nicht ausgerichteten Speicherspeicherorten wird unterstützt.

Weitere Informationen

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