Marshal.WriteByte 메서드
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
관리되지 않는 메모리에 싱글바이트 값을 씁니다.
오버로드
WriteByte(Object, Int32, Byte) |
사용되지 않습니다.
관리되지 않는 메모리의 지정된 오프셋 위치에 싱글바이트 값을 씁니다. |
WriteByte(IntPtr, Byte) |
관리되지 않는 메모리에 싱글바이트 값을 씁니다. |
WriteByte(IntPtr, Int32, Byte) |
관리되지 않는 메모리의 지정된 오프셋 위치에 싱글바이트 값을 씁니다. |
WriteByte(Object, Int32, Byte)
주의
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
작성할 값입니다.
- 특성
예외
기준 주소(ptr
)에 오프셋 바이트(ofs
)를 더하면 null 또는 잘못된 주소가 생성되는 경우
ptr
이 ArrayWithOffset 개체인 경우. 이 메서드에는 ArrayWithOffset 매개 변수를 사용할 수 없습니다.
설명
WriteByte 를 사용하면 관리되지 않는 C 스타일 바이트 배열과 직접 상호 작용할 수 있으므로 요소 값을 설정하기 전에 관리되지 않는 전체 배열(사용 Marshal.Copy)을 별도의 관리형 배열에 복사하는 비용이 제거됩니다.
추가 정보
적용 대상
WriteByte(IntPtr, Byte)
관리되지 않는 메모리에 싱글바이트 값을 씁니다.
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
nativeint
관리되지 않는 메모리에서 값을 쓸 주소입니다.
- val
- Byte
작성할 값입니다.
- 특성
예외
예제
다음 예제에서는 관리되지 않는 메모리 블록을 만들고, 관리되지 않는 메모리에 바이트를 쓰고, 관리되지 않는 메모리에서 바이트를 다시 읽은 다음, 관리되지 않는 메모리를 삭제합니다.
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)을 별도의 관리형 배열에 복사하는 비용이 제거됩니다.
추가 정보
적용 대상
WriteByte(IntPtr, Int32, Byte)
관리되지 않는 메모리의 지정된 오프셋 위치에 싱글바이트 값을 씁니다.
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
nativeint
관리되지 않는 메모리에서 값을 쓸 기본 주소입니다.
- ofs
- Int32
쓰기 전에 ptr
매개 변수에 추가되는 추가 바이트 오프셋입니다.
- val
- Byte
작성할 값입니다.
- 특성
예외
기준 주소(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
설명
WriteByte 를 사용하면 관리되지 않는 C 스타일 바이트 배열과 직접 상호 작용할 수 있으므로 요소 값을 설정하기 전에 관리되지 않는 전체 배열(사용 Marshal.Copy)을 별도의 관리형 배열에 복사하는 비용이 제거됩니다.