Marshal.ReadInt16 Yöntem

Tanım

Ad Alanı:

System.Runtime.InteropServices

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Runtime.InteropServices.dll

Yönetilmeyen bellekten 16 bit imzalı bir tamsayı okur. Hizalanmamış bellek konumlarından okuma desteklenir.

Aşırı Yüklemeler

Name	Description
ReadInt16(IntPtr)	Yönetilmeyen bellekten 16 bit imzalı bir tamsayı okur.
ReadInt16(IntPtr, Int32)	Yönetilmeyen bellekten belirli bir uzaklıkta 16 bit imzalı tamsayı okur.
ReadInt16(Object, Int32)	Geçersiz. Yönetilmeyen bellekten belirli bir uzaklıkta 16 bit imzalı tamsayı okur.

ReadInt16(IntPtr)

Kaynak:

Marshal.cs

Yönetilmeyen bellekten 16 bit imzalı bir tamsayı okur.

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

Parametreler

ptr

IntPtr

nativeint

Yönetilmeyen bellekte okunacak adres.

Döndürülenler

Int16

Yönetilmeyen bellekten okunan 16 bit imzalı tamsayı.

Özel durumlar

AccessViolationException

ptr tanınan bir biçim değildir.

-veya-

ptr, null'e eşittir.

-veya-

ptr geçersiz.

Örnekler

Aşağıdaki örnek, ve ReadInt16 yöntemlerini kullanarak WriteInt16 yönetilmeyen bir diziyi nasıl okuyup yazacaklarını gösterir.

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

Aşağıdaki örnekte, yönetilmeyen ReadInt16 bir değişkenin short değerini okumak için yönteminin nasıl kullanılacağı gösterilmektedir.

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);
}

Açıklamalar

ReadInt16 0 zımni uzaklığı vardır. Bu yöntem yönetilmeyen bir C stili Int16 diziyle doğrudan etkileşime olanak sağlayarak, öğe değerlerini okumadan önce yönetilmeyen dizinin tamamını (kullanarak Marshal.Copy) ayrı bir yönetilen diziye kopyalama masrafını ortadan kaldırır.

Hizalanmamış bellek konumlarından okuma desteklenir.

Ayrıca bkz.

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

ReadInt16(IntPtr, Int32)

Kaynak:

Marshal.cs

Yönetilmeyen bellekten belirli bir uzaklıkta 16 bit imzalı tamsayı okur.

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

Parametreler

ptr

IntPtr

nativeint

Yönetilmeyen bellekte okuması gereken temel adres.

ofs

Int32

Okumadan önce parametresine ptr eklenen ek bir bayt uzaklığı.

Döndürülenler

Int16

Verilen uzaklıkta yönetilmeyen bellekten okunan 16 bit imzalı tamsayı.

Özel durumlar

AccessViolationException

Temel adres (ptr) artı uzaklık bayt (ofs) null veya geçersiz bir adres üretir.

Örnekler

Aşağıdaki örnek, ve ReadInt16 yöntemlerini kullanarak WriteInt16 yönetilmeyen bir diziyi nasıl okuyup yazacaklarını gösterir.

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

Aşağıdaki örnekte, yönetilmeyen ReadInt16 bir değişkenin short değerini okumak için yönteminin nasıl kullanılacağı gösterilmektedir.

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);
}

Açıklamalar

ReadInt16 yönetilmeyen 16 bit imzalı bir diziyle doğrudan etkileşime olanak sağlayarak, öğe değerlerini okumadan önce yönetilmeyen dizinin tamamını (kullanarak Marshal.Copy) ayrı bir yönetilen diziye kopyalamanın masrafını ortadan kaldırır.

Hizalanmamış bellek konumlarından okuma desteklenir.

Ayrıca bkz.

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

ReadInt16(Object, Int32)

Kaynak:

Marshal.CoreCLR.cs

Dikkat

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

Yönetilmeyen bellekten belirli bir uzaklıkta 16 bit imzalı tamsayı okur.

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

[System.Obsolete("ReadInt16(Object, Int32) may be unavailable in future releases.")]
[System.Diagnostics.CodeAnalysis.RequiresDynamicCode("Marshalling code for the object might not be available")]
public static short ReadInt16(object ptr, int ofs);

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

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

Parametreler

ptr

Object

Kaynak nesnenin yönetilmeyen belleğindeki temel adres.

ofs

Int32

Okumadan önce parametresine ptr eklenen ek bir bayt uzaklığı.

Döndürülenler

Int16

Verilen uzaklıkta yönetilmeyen bellekten okunan 16 bit imzalı tamsayı.

Öznitelikler

ObsoleteAttribute RequiresDynamicCodeAttribute

Özel durumlar

AccessViolationException

Temel adres (ptr) artı uzaklık bayt (ofs) null veya geçersiz bir adres üretir.

ArgumentException

ptr bir ArrayWithOffset nesnedir. Bu yöntem parametreleri kabul ArrayWithOffset etmez.

Açıklamalar

ReadInt16 yönetilmeyen 16 bit imzalı bir diziyle doğrudan etkileşime olanak sağlayarak, öğe değerlerini okumadan önce yönetilmeyen dizinin tamamını (kullanarak Marshal.Copy) ayrı bir yönetilen diziye kopyalamanın masrafını ortadan kaldırır.

Hizalanmamış bellek konumlarından okuma desteklenir.

Ayrıca bkz.

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