Marshal.WriteByte Метод

Определение

Пространство имен:

System.Runtime.InteropServices

Сборки:

netstandard.dll, System.Runtime.InteropServices.dll

Записывает одно байтовое значение в неуправляемую память.

Перегрузки

Имя	Описание
WriteByte(Object, Int32, Byte)	Устаревшие. Записывает одно байтовое значение в неуправляемую память с указанным смещением.
WriteByte(IntPtr, Byte)	Записывает одно байтовое значение в неуправляемую память.
WriteByte(IntPtr, Int32, Byte)	Записывает одно байтовое значение в неуправляемую память с указанным смещением.

WriteByte(Object, Int32, Byte)

Исходный код:

Marshal.CoreCLR.cs

Внимание!

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

Записывает одно байтовое значение в неуправляемую память с указанным смещением.

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.Diagnostics.CodeAnalysis.RequiresDynamicCode("Marshalling code for the object might not be available")]
public static void WriteByte(object ptr, int ofs, byte val);

[<System.Obsolete("WriteByte(Object, Int32, Byte) may be unavailable in future releases.")>]
[<System.Diagnostics.CodeAnalysis.RequiresDynamicCode("Marshalling code for the object might not be available")>]
static member WriteByte : obj * int * byte -> unit

Public Shared Sub WriteByte (ptr As Object, ofs As Integer, val As Byte)

Параметры

ptr

Object

Базовый адрес в неуправляемой памяти целевого объекта.

ofs

Int32

Дополнительное смещение байтов, которое добавляется в параметр перед записью ptr .

val

Byte

Значение для записи.

Атрибуты

ObsoleteAttribute RequiresDynamicCodeAttribute

Исключения

AccessViolationException

Базовый адрес (ptr) плюс байт смещения (ofs) создает недопустимый или пустой адрес.

ArgumentException

ptr ArrayWithOffset— это объект. Этот метод не принимает ArrayWithOffset параметры.

Комментарии

WriteByte позволяет напрямую взаимодействовать с неуправляемым массивом байтов C, устраняя затраты на копирование всего неуправляемого массива (с помощью Marshal.Copy) в отдельный управляемый массив, прежде чем задавать его значения элементов.

См. также раздел

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

WriteByte(IntPtr, Byte)

Исходный код:

Marshal.cs

Записывает одно байтовое значение в неуправляемую память.

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)

Параметры

ptr

IntPtr

nativeint

Адрес в неуправляемой памяти для записи.

val

Byte

Значение для записи.

Исключения

AccessViolationException

ptr не является распознаваемым форматом.

–или–

ptr равно null.

–или–

ptr недопустим.

Примеры

В следующем примере создается блок неуправляемой памяти, записывает байт в неуправляемую память, считывает байт обратно из неуправляемой памяти, а затем удаляет неуправляемую память.

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

Комментарии

WriteByte позволяет напрямую взаимодействовать с неуправляемым массивом байтов C, устраняя затраты на копирование всего неуправляемого массива (с помощью Marshal.Copy) в отдельный управляемый массив, прежде чем задавать его значения элементов.

См. также раздел

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

WriteByte(IntPtr, Int32, Byte)

Исходный код:

Marshal.cs

Записывает одно байтовое значение в неуправляемую память с указанным смещением.

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)

Параметры

ptr

IntPtr

nativeint

Базовый адрес в неуправляемой памяти для записи.

ofs

Int32

Дополнительное смещение байтов, которое добавляется в параметр перед записью ptr .

val

Byte

Значение для записи.

Исключения

AccessViolationException

Базовый адрес (ptr) плюс байт смещения (ofs) создает недопустимый или пустой адрес.

Примеры

В следующем примере показано, как считывать и записывать данные в неуправляемый массив с помощью ReadByte методов и 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

Комментарии

WriteByte позволяет напрямую взаимодействовать с неуправляемым массивом байтов C, устраняя затраты на копирование всего неуправляемого массива (с помощью Marshal.Copy) в отдельный управляемый массив, прежде чем задавать его значения элементов.

См. также раздел

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