Marshal.ReadInt16 Metode

Definisi

Ruang nama:

System.Runtime.InteropServices

Rakitan:

System.Runtime.InteropServices.dll

Membaca bilangan bulat bertanda 16-bit dari memori yang tidak dikelola. Membaca dari lokasi memori yang tidak dialokasikan didukung.

Overload

ReadInt16(IntPtr)	Membaca bilangan bulat bertanda 16-bit dari memori yang tidak dikelola.
ReadInt16(IntPtr, Int32)	Membaca bilangan bulat bertanda tangan 16-bit pada offset tertentu dari memori yang tidak dikelola.
ReadInt16(Object, Int32)	Kedaluwarsa. Membaca bilangan bulat bertanda tangan 16-bit pada offset tertentu dari memori yang tidak dikelola.

ReadInt16(IntPtr)

Sumber:

Marshal.cs

Membaca bilangan bulat bertanda 16-bit dari memori yang tidak dikelola.

public:
 static short ReadInt16(IntPtr ptr);

public static short ReadInt16 (IntPtr ptr);

static member ReadInt16 : nativeint -> int16

Public Shared Function ReadInt16 (ptr As IntPtr) As Short

Parameter

ptr

IntPtr

nativeint

Alamat dalam memori yang tidak dikelola untuk dibaca.

Mengembalikan

Int16

Bilangan bulat bertanda tangan 16-bit dibaca dari memori yang tidak dikelola.

Pengecualian

AccessViolationException

ptr bukan format yang dikenali.

-atau-

ptr null.

-atau-

ptr tidak valid.

Contoh

Contoh berikut menunjukkan cara membaca dan menulis ke array yang tidak dikelola menggunakan metode ReadInt16 dan WriteInt16.

static void ReadWriteInt16()
{
    // Allocate unmanaged memory. 
    int elementSize = 2;
    IntPtr unmanagedArray = Marshal.AllocHGlobal(10 * elementSize);

    // Set the 10 elements of the C-style unmanagedArray
    for (int i = 0; i < 10; i++)
    {
        Marshal.WriteInt16(unmanagedArray, i * elementSize, ((Int16)(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.ReadInt16(unmanagedArray, i * elementSize));
    }

    Marshal.FreeHGlobal(unmanagedArray);

    Console.WriteLine("Done. Press Enter to continue.");
    Console.ReadLine();
}

Sub ReadWriteInt16()
    ' Allocate unmanaged memory. 
    Dim elementSize As Integer = 2
    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.WriteInt16(unmanagedArray, i * elementSize, CType(i + 1, Int16))
    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.ReadInt16(unmanagedArray, i * elementSize))
    Next i

    Marshal.FreeHGlobal(unmanagedArray)

    Console.WriteLine("Done. Press Enter to continue.")
    Console.ReadLine()
End Sub

Contoh berikut menunjukkan cara menggunakan metode ReadInt16 untuk membaca nilai variabel short yang tidak dikelola.

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



void main()
{
    // Create an unmanaged short.
    short myShort = 42;

    // Read the short as a managed Int16.
        Int16 ^ myManagedVal = Marshal::ReadInt16((IntPtr) &myShort);

    // Display the value to the console.
    Console::WriteLine(myManagedVal);
}

Keterangan

ReadInt16 memiliki offset tersirat 0. Metode ini memungkinkan interaksi langsung dengan array Int16 gaya C yang tidak dikelola, menghilangkan pengeluaran menyalin seluruh array yang tidak dikelola (menggunakan Marshal.Copy) ke array terkelola terpisah sebelum membaca nilai elemennya.

Membaca dari lokasi memori yang tidak dialokasikan didukung.

Lihat juga

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

ReadInt16(IntPtr, Int32)

Sumber:

Marshal.cs

Membaca bilangan bulat bertanda tangan 16-bit pada offset tertentu dari memori yang tidak dikelola.

public:
 static short ReadInt16(IntPtr ptr, int ofs);

public static short ReadInt16 (IntPtr ptr, int ofs);

static member ReadInt16 : nativeint * int -> int16

Public Shared Function ReadInt16 (ptr As IntPtr, ofs As Integer) As Short

Parameter

ptr

IntPtr

nativeint

Alamat dasar dalam memori yang tidak dikelola untuk dibaca.

ofs

Int32

Offset byte tambahan, yang ditambahkan ke parameter ptr sebelum membaca.

Mengembalikan

Int16

Bilangan bulat bertanda tangan 16-bit dibaca dari memori yang tidak dikelola pada offset yang diberikan.

Pengecualian

AccessViolationException

Alamat dasar (ptr) ditambah byte offset (ofs) menghasilkan alamat null atau tidak valid.

Contoh

Contoh berikut menunjukkan cara membaca dan menulis ke array yang tidak dikelola menggunakan metode ReadInt16 dan WriteInt16.

static void ReadWriteInt16()
{
    // Allocate unmanaged memory. 
    int elementSize = 2;
    IntPtr unmanagedArray = Marshal.AllocHGlobal(10 * elementSize);

    // Set the 10 elements of the C-style unmanagedArray
    for (int i = 0; i < 10; i++)
    {
        Marshal.WriteInt16(unmanagedArray, i * elementSize, ((Int16)(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.ReadInt16(unmanagedArray, i * elementSize));
    }

    Marshal.FreeHGlobal(unmanagedArray);

    Console.WriteLine("Done. Press Enter to continue.");
    Console.ReadLine();
}

Sub ReadWriteInt16()
    ' Allocate unmanaged memory. 
    Dim elementSize As Integer = 2
    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.WriteInt16(unmanagedArray, i * elementSize, CType(i + 1, Int16))
    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.ReadInt16(unmanagedArray, i * elementSize))
    Next i

    Marshal.FreeHGlobal(unmanagedArray)

    Console.WriteLine("Done. Press Enter to continue.")
    Console.ReadLine()
End Sub

Contoh berikut menunjukkan cara menggunakan metode ReadInt16 untuk membaca nilai variabel short yang tidak dikelola.

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

void main()
{
    // Create an unmanaged short pointer.
    short * myShort;
    short tmp = 42;
    // Initialize it to another value.
    myShort = &tmp;

    // Read value as a managed Int16.
    Int16 ^ myManagedVal = Marshal::ReadInt16((IntPtr) myShort, 0);

    // Display the value to the console.
    Console::WriteLine(myManagedVal);
}

Keterangan

ReadInt16 memungkinkan interaksi langsung dengan array yang ditandatangani 16-bit yang tidak dikelola, menghilangkan pengeluaran menyalin seluruh array yang tidak dikelola (menggunakan Marshal.Copy) ke array terkelola terpisah sebelum membaca nilai elemennya.

Membaca dari lokasi memori yang tidak dialokasikan didukung.

Lihat juga

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

ReadInt16(Object, Int32)

Sumber:

Marshal.CoreCLR.cs

Perhatian

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

Membaca bilangan bulat bertanda tangan 16-bit pada offset tertentu dari memori yang tidak dikelola.

public:
 static short ReadInt16(System::Object ^ ptr, int ofs);

[System.Obsolete("ReadInt16(Object, Int32) may be unavailable in future releases.")]
public static short ReadInt16 (object ptr, int ofs);

[<System.Obsolete("ReadInt16(Object, Int32) may be unavailable in future releases.")>]
static member ReadInt16 : obj * int -> int16

Public Shared Function ReadInt16 (ptr As Object, ofs As Integer) As Short

Parameter

ptr

Object

Alamat dasar dalam memori objek sumber yang tidak dikelola.

ofs

Int32

Offset byte tambahan, yang ditambahkan ke parameter ptr sebelum membaca.

Mengembalikan

Int16

Bilangan bulat bertanda tangan 16-bit dibaca dari memori yang tidak dikelola pada offset yang diberikan.

Atribut

ObsoleteAttribute

Pengecualian

AccessViolationException

Alamat dasar (ptr) ditambah byte offset (ofs) menghasilkan alamat null atau tidak valid.

ArgumentException

ptr adalah objek ArrayWithOffset. Metode ini tidak menerima parameter ArrayWithOffset.

Keterangan

ReadInt16 memungkinkan interaksi langsung dengan array yang ditandatangani 16-bit yang tidak dikelola, menghilangkan pengeluaran menyalin seluruh array yang tidak dikelola (menggunakan Marshal.Copy) ke array terkelola terpisah sebelum membaca nilai elemennya.

Membaca dari lokasi memori yang tidak dialokasikan didukung.

Lihat juga

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