Marshal.ReadByte Méthode

Définition

Espace de noms:
System.Runtime.InteropServices
Assemblys:
mscorlib.dll, System.Runtime.InteropServices.dll
Assembly:
mscorlib.dll
Assembly:
System.Runtime.InteropServices.dll
Assembly:
netstandard.dll

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

Surcharges

Nom Description
ReadByte(IntPtr, Int32)

Lit un octet unique à un décalage donné (ou index) de la mémoire non managée.
ReadByte(Object, Int32)
Obsolète.

Lit un octet unique à un décalage donné (ou index) de la mémoire non managée.
ReadByte(IntPtr)

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

ReadByte(IntPtr, Int32)

Lit un octet unique à un décalage donné (ou index) de la mémoire non managée.

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

Paramètres

ptr
IntPtr

nativeint

Adresse de base dans la mémoire non managée à partir de laquelle lire.

ofs
Int32

Décalage d’octet supplémentaire, ajouté au paramètre avant la ptr lecture.

Retours

Byte

Octet lu à partir de la mémoire non managée au décalage donné.

Attributs
SecurityCriticalAttribute

Exceptions

AccessViolationException

L’adresse de base (ptr) plus l’octet de décalage (ofs) produit une adresse null ou non valide.

Exemples

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

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.Copy) dans un tableau managé distinct avant de lire ses valeurs d’élément.

La lecture à partir d’emplacements de mémoire non alignés est prise en charge.

Voir aussi

S’applique à

ReadByte(Object, Int32)

Attention

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

Lit un octet unique à un décalage donné (ou index) de la mémoire non managée.

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);
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.")]
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
static member ReadByte : obj * int -> byte
[<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
Public Shared Function ReadByte (ptr As Object, ofs As Integer) As Byte

Paramètres

ptr
Object

Adresse de base en mémoire non managée de l’objet source.

ofs
Int32

Décalage d’octet supplémentaire, ajouté au paramètre avant la ptr lecture.

Retours

Byte

Octet lu à partir de la mémoire non managée au décalage donné.

Attributs
ObsoleteAttribute SecurityCriticalAttribute

Exceptions

AccessViolationException

L’adresse de base (ptr) plus l’octet de décalage (ofs) produit une adresse null ou non valide.

ArgumentException

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

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.Copy) dans un tableau managé distinct avant de lire ses valeurs d’élément.

La lecture à partir d’emplacements de mémoire non alignés est prise en charge.

Voir aussi

S’applique à

ReadByte(IntPtr)

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

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

Paramètres

ptr
IntPtr

nativeint

Adresse dans la mémoire non managée à partir de laquelle lire.

Retours

Byte

Octet lu à partir de la mémoire non managée.

Attributs
SecurityCriticalAttribute

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 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é, éliminant ainsi les frais de copie d’un tableau non managé entier (utilisant Marshal.Copy) dans un tableau managé distinct avant de lire ses valeurs d’élément.

La lecture à partir d’emplacements de mémoire non alignés est prise en charge.

Voir aussi

S’applique à