Marshal.WriteByte 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

Écrit une valeur d’octet unique en mémoire non managée.

Surcharges

Nom Description
WriteByte(Object, Int32, Byte)
Obsolète.

Écrit une valeur d’octet unique en mémoire non managée à un décalage spécifié.
WriteByte(IntPtr, Int32, Byte)

Écrit une valeur d’octet unique en mémoire non managée à un décalage spécifié.
WriteByte(IntPtr, Byte)

Écrit une valeur d’octet unique en mémoire non managée.

WriteByte(Object, Int32, Byte)

Attention

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

Écrit une valeur d’octet unique en mémoire non managée à un décalage spécifié.

public:
 static void WriteByte(System::Object ^ ptr, int ofs, System::Byte val);
[System.Obsolete("WriteByte(Object, Int32, Byte) may be unavailable in future releases.")]
[System.Security.SecurityCritical]
public static void WriteByte(object ptr, int ofs, byte val);
public static void WriteByte(object ptr, int ofs, byte val);
[System.Security.SecurityCritical]
public static void WriteByte(object ptr, int ofs, byte val);
[System.Obsolete("WriteByte(Object, Int32, Byte) may be unavailable in future releases.")]
public static void WriteByte(object ptr, int ofs, byte val);
[<System.Obsolete("WriteByte(Object, Int32, Byte) may be unavailable in future releases.")>]
[<System.Security.SecurityCritical>]
static member WriteByte : obj * int * byte -> unit
static member WriteByte : obj * int * byte -> unit
[<System.Security.SecurityCritical>]
static member WriteByte : obj * int * byte -> unit
[<System.Obsolete("WriteByte(Object, Int32, Byte) may be unavailable in future releases.")>]
static member WriteByte : obj * int * byte -> unit
Public Shared Sub WriteByte (ptr As Object, ofs As Integer, val As Byte)

Paramètres

ptr
Object

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

ofs
Int32

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

val
Byte

Valeur à écrire.

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

WriteByte 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) sur un tableau managé distinct avant de définir ses valeurs d’élément.

Voir aussi

S’applique à

WriteByte(IntPtr, Int32, Byte)

Écrit une valeur d’octet unique en mémoire non managée à un décalage spécifié.

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

Paramètres

ptr
IntPtr

nativeint

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

ofs
Int32

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

val
Byte

Valeur à écrire.

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

Remarques

WriteByte 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) sur un tableau managé distinct avant de définir ses valeurs d’élément.

Voir aussi

S’applique à

WriteByte(IntPtr, Byte)

Écrit une valeur d’octet unique en mémoire non managée.

public:
 static void WriteByte(IntPtr ptr, System::Byte val);
[System.Security.SecurityCritical]
public static void WriteByte(IntPtr ptr, byte val);
public static void WriteByte(IntPtr ptr, byte val);
[<System.Security.SecurityCritical>]
static member WriteByte : nativeint * byte -> unit
static member WriteByte : nativeint * byte -> unit
Public Shared Sub WriteByte (ptr As IntPtr, val As Byte)

Paramètres

ptr
IntPtr

nativeint

Adresse dans la mémoire non managée dans laquelle écrire.

val
Byte

Valeur à écrire.

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

Remarques

WriteByte 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) sur un tableau managé distinct avant de définir ses valeurs d’élément.

Voir aussi

S’applique à