Marshal.WriteByte Metodo

Definizione

Spazio dei nomi:
System.Runtime.InteropServices
Assembly:
mscorlib.dll, System.Runtime.InteropServices.dll
Assembly:
mscorlib.dll
Assembly:
System.Runtime.InteropServices.dll
Assembly:
netstandard.dll

Scrive un singolo valore di byte nella memoria non gestita.

Overload

Nome Descrizione
WriteByte(Object, Int32, Byte)
Obsoleti.

Scrive un singolo valore di byte nella memoria non gestita in corrispondenza di un offset specificato.
WriteByte(IntPtr, Int32, Byte)

Scrive un singolo valore di byte nella memoria non gestita in corrispondenza di un offset specificato.
WriteByte(IntPtr, Byte)

Scrive un singolo valore di byte nella memoria non gestita.

WriteByte(Object, Int32, Byte)

Attenzione

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

Scrive un singolo valore di byte nella memoria non gestita in corrispondenza di un offset specificato.

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)

Parametri

ptr
Object

Indirizzo di base nella memoria non gestita dell'oggetto di destinazione.

ofs
Int32

Offset di byte aggiuntivo, che viene aggiunto al parametro prima della ptr scrittura.

val
Byte

Valore da scrivere.

Attributi
ObsoleteAttribute SecurityCriticalAttribute

Eccezioni

AccessViolationException

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

ArgumentException

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

Commenti

WriteByte consente l'interazione diretta con una matrice di byte in stile C non gestita, eliminando i costi di copia di un'intera matrice non gestita (usando Marshal.Copy) in una matrice gestita separata prima di impostare i relativi valori di elemento.

Vedi anche

Si applica a

WriteByte(IntPtr, Int32, Byte)

Scrive un singolo valore di byte nella memoria non gestita in corrispondenza di un offset specificato.

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 in cui scrivere.

ofs
Int32

Offset di byte aggiuntivo, che viene aggiunto al parametro prima della ptr scrittura.

val
Byte

Valore da scrivere.

Attributi
SecurityCriticalAttribute

Eccezioni

AccessViolationException

L'indirizzo di base (ptr) più byte 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 i costi di copia di un'intera matrice non gestita (usando Marshal.Copy) in una matrice gestita separata prima di impostare i relativi valori di elemento.

Vedi anche

Si applica a

WriteByte(IntPtr, Byte)

Scrive un singolo valore di 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 in memoria non gestita in cui 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 i costi di copia di un'intera matrice non gestita (usando Marshal.Copy) in una matrice gestita separata prima di impostare i relativi valori di elemento.

Vedi anche

Si applica a