Marshal.WriteByte Метод

Ссылка

Определение

Пространство имен:: System.Runtime.InteropServices

Сборки:: mscorlib.dll, System.Runtime.InteropServices.dll

Сборки:: netstandard.dll, System.Runtime.InteropServices.dll

Сборка:: System.Runtime.InteropServices.dll

Сборка:: mscorlib.dll

Сборка:: netstandard.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

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

Перегрузки

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

WriteByte(Object, Int32, Byte)

Исходный код:: Marshal.CoreCLR.cs

Исходный код:: Marshal.CoreCLR.cs

Исходный код:: 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.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)

Параметры

ptr: Object

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

ofs: Int32

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

val: Byte

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

Атрибуты: ObsoleteAttribute SecurityCriticalAttribute

Исключения

AccessViolationException

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

ArgumentException

Параметр ptr является объектом ArrayWithOffset. Этот метод не принимает параметры ArrayWithOffset.

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

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

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

Применяется к

.NET 9 и другие версии

Продукт	Версии (Устарело)
.NET	(Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9)
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 (4.7 (package-provided), 4.7.1 (package-provided), 4.7.2 (package-provided), 4.8 (package-provided))
.NET Standard	1.1, 2.0 (1.2, 1.3, 1.4, 1.5, 1.6, 2.1)
UWP	(10.0)

WriteByte(IntPtr, Byte)

Исходный код:: Marshal.cs

Исходный код:: Marshal.cs

Исходный код:: Marshal.cs

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

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)

Параметры

ptr: IntPtr

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

val: Byte

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

Атрибуты: SecurityCriticalAttribute

Исключения

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

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

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

Применяется к

.NET 9 и другие версии

Продукт	Версии
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0

WriteByte(IntPtr, Int32, Byte)

Исходный код:: Marshal.cs

Исходный код:: Marshal.cs

Исходный код:: Marshal.cs

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

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)

Параметры

ptr: IntPtr

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

ofs: Int32

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

val: Byte

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

Атрибуты: SecurityCriticalAttribute

Исключения

AccessViolationException

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

Примеры

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

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

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

Применяется к

.NET 9 и другие версии

Продукт	Версии
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0

The future is yours

Поделиться через

Marshal.WriteByte Метод

Определение

Перегрузки

WriteByte(Object, Int32, Byte)

Параметры

Исключения

Комментарии

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

Применяется к

WriteByte(IntPtr, Byte)

Параметры

Исключения

Примеры

Комментарии

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

Применяется к

WriteByte(IntPtr, Int32, Byte)

Параметры

Исключения

Примеры

Комментарии

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

Применяется к

Дополнительные ресурсы