Marshal.WriteByte Méthode

Définition

Espace de noms:

System.Runtime.InteropServices

Assemblys:

netstandard.dll, System.Runtime.InteropServices.dll

Écrit une valeur d'octet unique dans la mémoire non managée.

Surcharges

WriteByte(Object, Int32, Byte)	Obsolète. Écrit une valeur d'octet unique dans la mémoire non managée à l'offset spécifié.
WriteByte(IntPtr, Byte)	Écrit une valeur d'octet unique dans la mémoire non managée.
WriteByte(IntPtr, Int32, Byte)	Écrit une valeur d'octet unique dans la mémoire non managée à l'offset spécifié.

WriteByte(Object, Int32, Byte)

Source:

Marshal.CoreCLR.cs

Attention

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

Écrit une valeur d'octet unique dans la mémoire non managée à l'offset spécifié.

C#

[System.Obsolete("WriteByte(Object, Int32, Byte) may be unavailable in future releases.")]
public static void WriteByte(object ptr, int ofs, byte val);

Paramètres

ptr

Object

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

ofs

Int32

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

val

Byte

Valeur à écrire.

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

WriteByte 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 définir ses valeurs d’élément.

Voir aussi

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

WriteByte(IntPtr, Byte)

Source:

Marshal.cs

Écrit une valeur d'octet unique dans la mémoire non managée.

C#

public static void WriteByte(IntPtr ptr, byte val);

Paramètres

ptr

IntPtr

Adresse où écrire dans la mémoire non managée.

val

Byte

Valeur à écrire.

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.

C#

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

Remarques

WriteByte 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 définir ses valeurs d’élément.

Voir aussi

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

WriteByte(IntPtr, Int32, Byte)

Source:

Marshal.cs

Écrit une valeur d'octet unique dans la mémoire non managée à l'offset spécifié.

C#

public static void WriteByte(IntPtr ptr, int ofs, byte val);

Paramètres

ptr

IntPtr

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

ofs

Int32

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

val

Byte

Valeur à écrire.

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 .

C#

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

Remarques

WriteByte 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 définir ses valeurs d’élément.

Voir aussi

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