Marshal.ReadByte Methode

Quelle:

Marshal.cs

Quelle:

Marshal.cs

Quelle:

Marshal.cs

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

Gibt zurück

The byte read from unmanaged memory at the given offset.

Attribute

SecurityCriticalAttribute

Ausnahmen

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)

Quelle:

Marshal.CoreCLR.cs

Quelle:

Marshal.CoreCLR.cs

Quelle:

Marshal.CoreCLR.cs

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

Gibt zurück

The byte read from unmanaged memory at the given offset.

Attribute

ObsoleteAttribute SecurityCriticalAttribute

Ausnahmen

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)

Quelle:

Marshal.cs

Quelle:

Marshal.cs

Quelle:

Marshal.cs

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

Gibt zurück

Das Byte, das aus nicht verwalteten Arbeitsspeicher gelesen wird.

Attribute

SecurityCriticalAttribute

Ausnahmen

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)