Marshal.ReadByte Methode

Definition

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)

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

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

Parameter

ptr
IntPtr

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.

Attribute

Ausnahmen

Die Basisadresse (ptr) und das Offsetbyte (ofs) erzeugen NULL oder eine ungültige Adresse.

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie ein nicht verwaltetes Array mithilfe der Methoden und gelesen und in ein nicht verwaltetes Array geschrieben ReadByte WriteByte wird.

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

Das Lesen aus nicht ausgerichteten Speicheradressen wird unterstützt.

Siehe auch

Gilt für

ReadByte(Object, Int32)

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.")]
[System.Security.SecurityCritical]
public static byte ReadByte (object ptr, int ofs);
[System.Obsolete("ReadByte(Object, Int32) may be unavailable in future releases.")]
public static byte ReadByte (object ptr, int ofs);
public static byte ReadByte (object ptr, int ofs);
[System.Security.SecurityCritical]
public static byte ReadByte (object ptr, int ofs);
[<System.Obsolete("ReadByte(Object, Int32) may be unavailable in future releases.")>]
[<System.Security.SecurityCritical>]
static member ReadByte : obj * int -> byte
[<System.Obsolete("ReadByte(Object, Int32) may be unavailable in future releases.")>]
static member ReadByte : obj * int -> byte
static member ReadByte : obj * int -> byte
[<System.Security.SecurityCritical>]
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

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

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

Das Lesen aus nicht ausgerichteten Speicheradressen wird unterstützt.

Siehe auch

Gilt für

ReadByte(IntPtr)

Liest ein einzelnes Byte aus dem nicht verwalteten Speicher.

public:
 static System::Byte ReadByte(IntPtr ptr);
[System.Security.SecurityCritical]
public static byte ReadByte (IntPtr ptr);
public static byte ReadByte (IntPtr ptr);
[<System.Security.SecurityCritical>]
static member ReadByte : nativeint -> byte
static member ReadByte : nativeint -> byte
Public Shared Function ReadByte (ptr As IntPtr) As Byte

Parameter

ptr
IntPtr

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

Gibt zurück

Byte

Das aus dem nicht verwalteten Arbeitsspeicher gelesene Byte.

Attribute

Ausnahmen

ptr ist kein erkanntes Format.

- oder - ptr ist null.

- oder - ptr ist ungültig.

Beispiele

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

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 die Kosten für das Kopieren eines gesamten nicht verwalteten Arrays (mit ) in ein separates verwaltetes Array beseitigt werden, Marshal.Copy bevor die Elementwerte gelesen werden.

Das Lesen aus nicht ausgerichteten Speicheradressen wird unterstützt.

Siehe auch

Gilt für