Marshal.WriteByte Metodo

Definizione

Spazio dei nomi:

System.Runtime.InteropServices

Assembly:

System.Runtime.InteropServices.dll

Scrive un valore a singolo byte nella memoria non gestita.

Overload

WriteByte(Object, Int32, Byte)	Obsoleti. Scrive un valore a singolo byte nella memoria non gestita a un offset specifico.
WriteByte(IntPtr, Byte)	Scrive un valore a singolo byte nella memoria non gestita.
WriteByte(IntPtr, Int32, Byte)	Scrive un valore a singolo byte nella memoria non gestita a un offset specifico.

WriteByte(Object, Int32, Byte)

Origine:

Marshal.CoreCLR.cs

Attenzione

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

Scrive un valore a singolo byte nella memoria non gestita a un offset specifico.

public:
 static void WriteByte(System::Object ^ ptr, int ofs, System::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.")>]
static member WriteByte : obj * int * byte -> unit

Public Shared Sub WriteByte (ptr As Object, ofs As Integer, val As Byte)

Parametri

ptr

Object

L'indirizzo di base dell'oggetto di destinazione nella memoria non gestita.

ofs

Int32

Offset di byte supplementare, aggiunto al parametro ptr prima della scrittura.

val

Byte

Valore da scrivere.

Attributi

ObsoleteAttribute

Eccezioni

AccessViolationException

L'indirizzo di base (ptr) più il byte di offset (ofs) produce un indirizzo Null o non valido.

ArgumentException

ptr è un oggetto ArrayWithOffset. Questo metodo non accetta parametri ArrayWithOffset.

Commenti

WriteByte consente l'interazione diretta con una matrice di byte in stile C non gestita, eliminando il costo di copiare un'intera matrice non gestita (usando Marshal.Copy) in una matrice gestita separata prima di impostare i valori degli elementi.

Vedi anche

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

WriteByte(IntPtr, Byte)

Origine:

Marshal.cs

Scrive un valore a singolo byte nella memoria non gestita.

public:
 static void WriteByte(IntPtr ptr, System::Byte val);

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

static member WriteByte : nativeint * byte -> unit

Public Shared Sub WriteByte (ptr As IntPtr, val As Byte)

Parametri

ptr

IntPtr

nativeint

Indirizzo nella memoria non gestita sul quale scrivere.

val

Byte

Valore da scrivere.

Eccezioni

AccessViolationException

ptr non è un formato riconosciuto.

-oppure-

ptr è null.

-oppure-

ptr non è valido.

Esempio

L'esempio seguente crea un blocco di memoria non gestita, scrive un byte nella memoria non gestita, legge il byte dalla memoria non gestita e quindi elimina la memoria non gestita.

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

Commenti

WriteByte consente l'interazione diretta con una matrice di byte in stile C non gestita, eliminando il costo di copiare un'intera matrice non gestita (usando Marshal.Copy) in una matrice gestita separata prima di impostare i valori degli elementi.

Vedi anche

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

WriteByte(IntPtr, Int32, Byte)

Origine:

Marshal.cs

Scrive un valore a singolo byte nella memoria non gestita a un offset specifico.

public:
 static void WriteByte(IntPtr ptr, int ofs, System::Byte val);

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

static member WriteByte : nativeint * int * byte -> unit

Public Shared Sub WriteByte (ptr As IntPtr, ofs As Integer, val As Byte)

Parametri

ptr

IntPtr

nativeint

Indirizzo di base nella memoria non gestita su cui scrivere.

ofs

Int32

Offset di byte supplementare, aggiunto al parametro ptr prima della scrittura.

val

Byte

Valore da scrivere.

Eccezioni

AccessViolationException

L'indirizzo di base (ptr) più il byte di offset (ofs) produce un indirizzo Null o non valido.

Esempio

Nell'esempio seguente viene illustrato come leggere e scrivere in una matrice non gestita usando i ReadByte metodi e 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

Commenti

WriteByte consente l'interazione diretta con una matrice di byte in stile C non gestita, eliminando il costo di copiare un'intera matrice non gestita (usando Marshal.Copy) in una matrice gestita separata prima di impostare i valori degli elementi.

Vedi anche

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