Marshal.WriteByte Metodo

  • Riferimento

Definizione

Spazio dei nomi:
System.Runtime.InteropServices
Assembly:
System.Runtime.InteropServices.dll
Assembly:
mscorlib.dll
Assembly:
netstandard.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
Origine:
Marshal.CoreCLR.cs
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.")]
[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);
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.")>]
[<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
static member WriteByte : obj * int * byte -> unit
[<System.Security.SecurityCritical>]
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 SecurityCriticalAttribute

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

Si applica a

WriteByte(IntPtr, Byte)

Origine:
Marshal.cs
Origine:
Marshal.cs
Origine:
Marshal.cs

Scrive un valore a singolo byte nella memoria non gestita.

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)

Parametri

ptr
IntPtr

nativeint

Indirizzo nella memoria non gestita sul quale scrivere.

val
Byte

Valore da scrivere.

Attributi
SecurityCriticalAttribute

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

Si applica a

WriteByte(IntPtr, Int32, Byte)

Origine:
Marshal.cs
Origine:
Marshal.cs
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);
[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)

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.

Attributi
SecurityCriticalAttribute

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

Si applica a