Marshal.WriteByte Metodo

Riferimento

Definizione

Spazio dei nomi:: System.Runtime.InteropServices

Assembly:: System.Runtime.InteropServices.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Scrive un valore a singolo byte nella memoria non gestita.

Overload

WriteByte(Object, Int32, Byte)	Obsoleta. 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)

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 di tipo C non gestita, eliminando la spesa per copiare un'intera matrice non gestita (usando Marshal.Copy) in una matrice gestita separata prima di impostare i relativi valori di elemento.

Vedi anche

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

Si applica a

WriteByte(IntPtr, Byte)

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

Nell'esempio seguente viene creato un blocco di memoria non gestita, scrive un byte nella memoria non gestita, legge il byte indietro 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

Vedi anche

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

Si applica a

WriteByte(IntPtr, Int32, Byte)

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

Vedi anche

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

Si applica a

Marshal.WriteByte Metodo

Definizione

Overload

WriteByte(Object, Int32, Byte)

Parametri

Eccezioni

Commenti

Vedi anche

Si applica a

WriteByte(IntPtr, Byte)

Parametri

Eccezioni

Esempio

Commenti

Vedi anche

Si applica a

WriteByte(IntPtr, Int32, Byte)

Parametri

Eccezioni

Esempio

Commenti

Vedi anche

Si applica a

Risorse aggiuntive