Marshal.WriteByte Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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)
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.")]
[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 -> unitstatic member WriteByte : obj * int * byte -> unit[<System.Security.SecurityCritical>]
static member WriteByte : obj * int * byte -> unitPublic 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
Exceções
O endereço básico (ptr) e o deslocamento de byte (ofs) produz um endereço nulo ou inválido.
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 no 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
Aplica-se a
WriteByte(IntPtr, Byte)
Grava um valor de byte único na memória não gerenciada.
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 -> unitstatic member WriteByte : nativeint * byte -> unitPublic 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.
- Atributos
Exceções
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 no 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
Aplica-se a
WriteByte(IntPtr, Int32, Byte)
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);[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 -> unitstatic member WriteByte : nativeint * int * byte -> unitPublic 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.
- Atributos
Exceções
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 métodos e WriteByte os ReadByte métodos.
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 no 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.