Marshal.ReadByte Méthode

Définition

Espace de noms:

System.Runtime.InteropServices

Assembly:

System.Runtime.InteropServices.dll

Lit un octet unique à partir de la mémoire non managée. La lecture depuis des emplacements mémoire non alignés est prise en charge.

Surcharges

ReadByte(IntPtr, Int32)	Lit un seul octet à un offset (ou index) donné dans la mémoire managée.
ReadByte(Object, Int32)	Obsolète. Lit un seul octet à un offset (ou index) donné dans la mémoire managée.
ReadByte(IntPtr)	Lit un octet unique à partir de la mémoire non managée.

ReadByte(IntPtr, Int32)

Source:

Marshal.cs

Lit un seul octet à un offset (ou index) donné dans la mémoire managée.

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

Paramètres

ptr

IntPtr

nativeint

Adresse de base dans la mémoire non managée où commencer la lecture.

ofs

Int32

Offset d'octet supplémentaire, qui est ajouté au paramètre ptr avant la lecture.

Retours

Byte

Octet lu dans la mémoire non managée à l'offset donné.

Exceptions

AccessViolationException

L'adresse de base (ptr) plus l'octet d'offset (ofs) produisent une adresse null ou non valide.

Exemples

L’exemple suivant montre comment lire et écrire dans un tableau non managé à l’aide des ReadByte méthodes et WriteByte .

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

L’exemple suivant montre comment utiliser la ReadByte méthode pour lire la valeur d’un caractère non managé.

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);
}

Remarques

ReadByte permet une interaction directe avec un tableau d’octets de style C non managé, éliminant ainsi les frais de copie d’un tableau non managé entier (à l’aide Marshal.Copyde ) dans un tableau managé distinct avant de lire ses valeurs d’élément.

La lecture depuis des emplacements mémoire non alignés est prise en charge.

Voir aussi

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

ReadByte(Object, Int32)

Source:

Marshal.CoreCLR.cs

Attention

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

Lit un seul octet à un offset (ou index) donné dans la mémoire managée.

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

Paramètres

ptr

Object

Adresse de base dans la mémoire non managée de l'objet source.

ofs

Int32

Offset d'octet supplémentaire, qui est ajouté au paramètre ptr avant la lecture.

Retours

Byte

Octet lu dans la mémoire non managée à l'offset donné.

Attributs

ObsoleteAttribute

Exceptions

AccessViolationException

L'adresse de base (ptr) plus l'octet d'offset (ofs) produisent une adresse null ou non valide.

ArgumentException

ptr est un objet ArrayWithOffset. Cette méthode n'accepte pas les paramètres ArrayWithOffset.

Remarques

ReadByte permet une interaction directe avec un tableau d’octets de style C non managé, éliminant ainsi les frais de copie d’un tableau non managé entier (à l’aide Marshal.Copyde ) dans un tableau managé distinct avant de lire ses valeurs d’élément.

La lecture depuis des emplacements mémoire non alignés est prise en charge.

Voir aussi

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

ReadByte(IntPtr)

Source:

Marshal.cs

Lit un octet unique à partir de la mémoire non managée.

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

Paramètres

ptr

IntPtr

nativeint

Adresse de début de lecture dans la mémoire non managée.

Retours

Byte

Octet lu dans la mémoire non managée.

Exceptions

AccessViolationException

ptr n'est pas un format reconnu.

- ou -

ptr a la valeur null.

- ou -

ptr n'est pas valide.

Exemples

L’exemple suivant crée un bloc de mémoire non managée, écrit un octet dans la mémoire non managée, lit l’octet à partir de la mémoire non managée, puis supprime la mémoire non managée.

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

L’exemple suivant montre comment utiliser la ReadByte méthode pour lire la valeur d’un caractère non managé.

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);
}

Remarques

ReadByte a un décalage implicite de 0. Cette méthode permet une interaction directe avec un tableau d’octets de style C non managé, ce qui élimine les frais de copie d’un tableau non managé entier (à l’aide Marshal.Copyde ) dans un tableau managé distinct avant de lire ses valeurs d’élément.

La lecture depuis des emplacements mémoire non alignés est prise en charge.

Voir aussi

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