Marshal.WriteByte Método

Definição

Namespace:

System.Runtime.InteropServices

Assembly:

System.Runtime.InteropServices.dll

Grava um valor de byte único na memória não gerenciada.

Sobrecargas

WriteByte(Object, Int32, Byte)	Obsoleto. Grava um valor de byte único na memória não gerenciada em um deslocamento especificado.
WriteByte(IntPtr, Byte)	Grava um valor de byte único na memória não gerenciada.
WriteByte(IntPtr, Int32, Byte)	Grava um valor de byte único na memória não gerenciada em um deslocamento especificado.

WriteByte(Object, Int32, Byte)

Origem:

Marshal.CoreCLR.cs

Cuidado

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

Grava um valor de byte único na memória não gerenciada em um deslocamento especificado.

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)

Parâmetros

ptr

Object

O endereço básico em memória não gerenciada do objeto de destino.

ofs

Int32

Um deslocamento de byte adicional, que é adicionado para o parâmetro ptr antes de gravar.

val

Byte

O valor a ser gravado.

Atributos

ObsoleteAttribute

Exceções

AccessViolationException

O endereço básico (ptr) e o deslocamento de byte (ofs) produz um endereço nulo ou inválido.

ArgumentException

ptr é um objeto ArrayWithOffset. Esse método não aceita parâmetros ArrayWithOffset.

Comentários

WriteByte permite a interação direta com uma matriz de bytes de estilo C não gerenciada, eliminando a despesa de copiar uma matriz não gerenciada inteira (usando Marshal.Copy) para uma matriz gerenciada separada antes de definir seus valores de elemento.

Confira também

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

WriteByte(IntPtr, Byte)

Origem:

Marshal.cs

Grava um valor de byte único na memória não gerenciada.

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)

Parâmetros

ptr

IntPtr

nativeint

O endereço a ser gravado na memória não gerenciada.

val

Byte

O valor a ser gravado.

Exceções

AccessViolationException

ptr não é um formato reconhecido.

- ou -

ptr é null.

- ou -

ptr é inválido.

Exemplos

O exemplo a seguir cria um bloco de memória não gerenciada, grava um byte na memória não gerenciada, lê o byte de volta da memória não gerenciada e descarta a memória não gerenciada.

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

Comentários

WriteByte permite a interação direta com uma matriz de bytes de estilo C não gerenciada, eliminando a despesa de copiar uma matriz não gerenciada inteira (usando Marshal.Copy) para uma matriz gerenciada separada antes de definir seus valores de elemento.

Confira também

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

WriteByte(IntPtr, Int32, Byte)

Origem:

Marshal.cs

Grava um valor de byte único na memória não gerenciada em um deslocamento especificado.

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)

Parâmetros

ptr

IntPtr

nativeint

O endereço básico na memória não gerenciada no qual gravar.

ofs

Int32

Um deslocamento de byte adicional, que é adicionado para o parâmetro ptr antes de gravar.

val

Byte

O valor a ser gravado.

Exceções

AccessViolationException

O endereço básico (ptr) e o deslocamento de byte (ofs) produz um endereço nulo ou inválido.

Exemplos

O exemplo a seguir demonstra como ler e gravar em uma matriz não gerenciada usando os ReadByte métodos 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

Comentários

WriteByte permite a interação direta com uma matriz de bytes de estilo C não gerenciada, eliminando a despesa de copiar uma matriz não gerenciada inteira (usando Marshal.Copy) para uma matriz gerenciada separada antes de definir seus valores de elemento.

Confira também

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