Marshal.ReadByte Marshal.ReadByte Marshal.ReadByte Marshal.ReadByte Method

정의

관리되지 않는 메모리에서 싱글바이트를 읽습니다.Reads a single byte from unmanaged memory. 정렬되지 않은 메모리 위치에서 읽을 수 있습니다.Reading from unaligned memory locations is supported.

오버로드

ReadByte(IntPtr, Int32) ReadByte(IntPtr, Int32) ReadByte(IntPtr, Int32) ReadByte(IntPtr, Int32)

관리되지 않는 메모리의 지정된 오프셋(또는 인덱스) 위치에서 싱글바이트를 읽습니다.Reads a single byte at a given offset (or index) from unmanaged memory.

ReadByte(Object, Int32) ReadByte(Object, Int32) ReadByte(Object, Int32) ReadByte(Object, Int32)

관리되지 않는 메모리의 지정된 오프셋(또는 인덱스) 위치에서 싱글바이트를 읽습니다.Reads a single byte at a given offset (or index) from unmanaged memory.

ReadByte(IntPtr) ReadByte(IntPtr) ReadByte(IntPtr) ReadByte(IntPtr)

관리되지 않는 메모리에서 싱글바이트를 읽습니다.Reads a single byte from unmanaged memory.

ReadByte(IntPtr, Int32) ReadByte(IntPtr, Int32) ReadByte(IntPtr, Int32) ReadByte(IntPtr, Int32)

관리되지 않는 메모리의 지정된 오프셋(또는 인덱스) 위치에서 싱글바이트를 읽습니다.Reads a single byte at a given offset (or index) from unmanaged memory.

public:
 static System::Byte ReadByte(IntPtr ptr, int ofs);
[System.Security.SecurityCritical]
public static byte ReadByte (IntPtr ptr, int ofs);
static member ReadByte : nativeint * int -> byte
Public Shared Function ReadByte (ptr As IntPtr, ofs As Integer) As Byte

매개 변수

ptr
IntPtr IntPtr IntPtr IntPtr

읽을 관리되지 않는 메모리의 기본 주소입니다.The base address in unmanaged memory from which to read.

ofs
Int32 Int32 Int32 Int32

읽기 전에 ptr 매개 변수에 추가되는 추가 바이트 오프셋입니다.An additional byte offset, which is added to the ptr parameter before reading.

반환

관리되지 않는 메모리의 지정된 오프셋 위치에서 읽은 바이트입니다.The byte read from unmanaged memory at the given offset.

예외

기준 주소(ptr)에 오프셋 바이트(ofs)를 더하면 null 또는 잘못된 주소가 생성되는 경우Base address (ptr) plus offset byte (ofs) produces a null or invalid address.

예제

다음 예제에서는 사용 하는 관리 되지 않는 배열에 읽기 및 쓰기에 대 한 방법에 설명 합니다 ReadByteWriteByte 메서드.The following example demonstrates how to read and write to an unmanaged array using the ReadByte and WriteByte methods.

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

다음 예제에서는 사용 하는 방법에 설명 합니다 ReadByte 메서드는 관리 되지 않는 문자의 값을 읽을 수 있습니다.The following example demonstrates how to use the ReadByte method to read the value of an unmanaged character.


using namespace System;
using namespace System::Runtime::InteropServices;



void main()
{
	// Create an unmanaged byte.
	const char * myString = "bB";

	// Read the second character of the c string as a managed byte.
        Byte ^ myManagedByte = Marshal::ReadByte((IntPtr) (char *) myString, 1);

	// Display the byte to the console.
	Console::WriteLine(myManagedByte);
}

설명

ReadByte 직접 관리 되지 않는 배열 전체를 복사를 제거 하는 관리 되지 않는 C-스타일 바이트 배열와 상호 작용 수 있으므로 (사용 하 여 Marshal.Copy) 해당 요소 값을 읽기 전에 별도 관리 되는 배열에 있습니다.ReadByte enables direct interaction with an unmanaged C-style byte array, eliminating the expense of copying an entire unmanaged array (using Marshal.Copy) to a separate managed array before reading its element values.

정렬되지 않은 메모리 위치에서 읽을 수 있습니다.Reading from unaligned memory locations is supported.

보안

SecurityCriticalAttribute
직접 실행 호출자에 대 한 완전 신뢰가 필요 합니다.requires full trust for the immediate caller. 이 멤버는 부분적으로 신뢰할 수 있는 또는 투명 코드에서 사용할 수 없습니다.This member cannot be used by partially trusted or transparent code.

추가 정보

ReadByte(Object, Int32) ReadByte(Object, Int32) ReadByte(Object, Int32) ReadByte(Object, Int32)

경고

이 API는 현재 사용되지 않습니다.

관리되지 않는 메모리의 지정된 오프셋(또는 인덱스) 위치에서 싱글바이트를 읽습니다.Reads a single byte at a given offset (or index) from unmanaged memory.

public:
 static System::Byte ReadByte(System::Object ^ ptr, int ofs);
[System.Obsolete("ReadByte(Object, Int32) may be unavailable in future releases.")]
[System.Security.SecurityCritical]
public static byte ReadByte (object ptr, int ofs);
static member ReadByte : obj * int -> byte
Public Shared Function ReadByte (ptr As Object, ofs As Integer) As Byte

매개 변수

ptr
Object Object Object Object

소스 개체에 대한 관리되지 않는 메모리의 기본 주소입니다.The base address in unmanaged memory of the source object.

ofs
Int32 Int32 Int32 Int32

읽기 전에 ptr 매개 변수에 추가되는 추가 바이트 오프셋입니다.An additional byte offset, which is added to the ptr parameter before reading.

반환

관리되지 않는 메모리의 지정된 오프셋 위치에서 읽은 바이트입니다.The byte read from unmanaged memory at the given offset.

예외

기준 주소(ptr)에 오프셋 바이트(ofs)를 더하면 null 또는 잘못된 주소가 생성되는 경우Base address (ptr) plus offset byte (ofs) produces a null or invalid address.

ptrArrayWithOffset 개체인 경우.ptr is an ArrayWithOffset object. 이 메서드에는 ArrayWithOffset 매개 변수를 사용할 수 없습니다.This method does not accept ArrayWithOffset parameters.

설명

ReadByte 직접 관리 되지 않는 배열 전체를 복사를 제거 하는 관리 되지 않는 C-스타일 바이트 배열와 상호 작용 수 있으므로 (사용 하 여 Marshal.Copy) 해당 요소 값을 읽기 전에 별도 관리 되는 배열에 있습니다.ReadByte enables direct interaction with an unmanaged C-style byte array, eliminating the expense of copying an entire unmanaged array (using Marshal.Copy) to a separate managed array before reading its element values.

정렬되지 않은 메모리 위치에서 읽을 수 있습니다.Reading from unaligned memory locations is supported.

보안

SecurityCriticalAttribute
직접 실행 호출자에 대 한 완전 신뢰가 필요 합니다.requires full trust for the immediate caller. 이 멤버는 부분적으로 신뢰할 수 있는 또는 투명 코드에서 사용할 수 없습니다.This member cannot be used by partially trusted or transparent code.

추가 정보

ReadByte(IntPtr) ReadByte(IntPtr) ReadByte(IntPtr) ReadByte(IntPtr)

관리되지 않는 메모리에서 싱글바이트를 읽습니다.Reads a single byte from unmanaged memory.

public:
 static System::Byte ReadByte(IntPtr ptr);
[System.Security.SecurityCritical]
public static byte ReadByte (IntPtr ptr);
static member ReadByte : nativeint -> byte
Public Shared Function ReadByte (ptr As IntPtr) As Byte

매개 변수

ptr
IntPtr IntPtr IntPtr IntPtr

읽을 관리되지 않는 메모리의 주소입니다.The address in unmanaged memory from which to read.

반환

관리되지 않는 메모리에서 읽은 바이트입니다.The byte read from unmanaged memory.

예외

ptr의 형식을 인식할 수 없는 경우ptr is not a recognized format.

또는-or- ptrnull인 경우ptr is null.

또는-or- ptr이 잘못되었습니다.ptr is invalid.

예제

다음 예제에서는 관리 되지 않는 메모리 블록을 만듭니다, 그리고 관리 되지 않는 메모리에 바이트를 씁니다, 그리고 관리 되지 않는 메모리에서 바이트를 읽고 및 관리 되지 않는 메모리를 삭제 합니다.The following example creates a block of unmanaged memory, writes a byte to the unmanaged memory, reads the byte back from unmanaged memory, and then disposes the unmanaged memory.

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
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

다음 예제에서는 사용 하는 방법에 설명 합니다 ReadByte 메서드는 관리 되지 않는 문자의 값을 읽을 수 있습니다.The following example demonstrates how to use the ReadByte method to read the value of an unmanaged character.


using namespace System;
using namespace System::Runtime::InteropServices;



void main()
{
	// Create an unmanaged byte.
	const char * myString = "b";

	// Read the c string as a managed byte.
        Byte ^ myManagedByte = Marshal::ReadByte((IntPtr) (char *) myString);

	// Display the byte to the console.
	Console::WriteLine(myManagedByte);
}

설명

ReadByte 암시 된 오프셋이 0에 있습니다.ReadByte has an implied offset of 0. 이 메서드를 사용 하면 관리 되지 않는 배열 전체를 복사를 제거 하는 관리 되지 않는 C-스타일 바이트 배열와 직접 상호 작용 (사용 하 여 Marshal.Copy) 해당 요소 값을 읽기 전에 별도 관리 되는 배열입니다.This method enables direct interaction with an unmanaged C-style byte array, eliminating the expense of copying an entire unmanaged array (using Marshal.Copy) to a separate managed array before reading its element values.

정렬되지 않은 메모리 위치에서 읽을 수 있습니다.Reading from unaligned memory locations is supported.

보안

SecurityCriticalAttribute
직접 실행 호출자에 대 한 완전 신뢰가 필요 합니다.requires full trust for the immediate caller. 이 멤버는 부분적으로 신뢰할 수 있는 또는 투명 코드에서 사용할 수 없습니다.This member cannot be used by partially trusted or transparent code.

추가 정보

적용 대상