MarshalAsAttribute.SizeParamIndex Bidang

Definisi

Ruang nama:

System.Runtime.InteropServices

Rakitan:

System.Runtime.InteropServices.dll

Sumber:

MarshalAsAttribute.cs

Menunjukkan parameter berbasis nol yang berisi jumlah elemen array, mirip size_is dengan di COM.

public: short SizeParamIndex;

public short SizeParamIndex;

val mutable SizeParamIndex : int16

Public SizeParamIndex As Short 

Nilai Bidang

Int16

Contoh

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

// Force the layout of your fields to the C-style struct layout.
// Without this, the .NET Framework will reorder your fields.

[StructLayoutAttribute(LayoutKind::Sequential)]
value struct Vertex
{
public:
   float x;
   float y;
   float z;
};


// Add [In] or [In, Out] attributes as appropriate.
// Marshal as a C-style array of Vertex, where the second (SizeParamIndex is zero-based)
// parameter (size) contains the count of array elements.

[DllImport("SomeDLL.dll")]
extern void SomeUnsafeMethod( [MarshalAs(UnmanagedType::LPArray,SizeParamIndex=1)]array<Vertex>^data, long size );
int main()
{
   array<Vertex>^verts = gcnew array<Vertex>(3);
   SomeUnsafeMethod( verts, verts->Length );
}

using System.Runtime.InteropServices;
using SomeNamespace;

namespace SomeNamespace
{
    // Force the layout of your fields to the C style struct layout.
    // Without this, the .NET Framework will reorder your fields.
    [StructLayout(LayoutKind.Sequential)]
    public struct Vertex
    {
        float	x;
    float	y;
        float	z;
    }

    class SomeClass
    {
        // Add [In] or [In, Out] attributes as approppriate.
        // Marshal as a C style array of Vertex, where the second (SizeParamIndex is zero-based)
        //  parameter (size) contains the count of array elements.
        [DllImport ("SomeDll.dll")]
        public static extern void SomeUnsafeMethod(
                                      [MarshalAs(UnmanagedType.LPArray, SizeParamIndex=1)] Vertex[] data,
                                      long size );

        public void SomeMethod()
        {
            Vertex[] verts = new Vertex[3];
            SomeUnsafeMethod( verts, verts.Length );
        }
    }
}

class Test
{
    public static void Main()
    {
        SomeClass AClass = new SomeClass();

        AClass.SomeMethod();
    }
}

Option Strict Off

Imports System.Runtime.InteropServices
Imports SomeNamespace

Namespace SomeNamespace
    ' Force the layout of your fields to the C style struct layout.
    ' Without this, the .NET Framework will reorder your fields.
    
    <StructLayout(LayoutKind.Sequential)> _
    Structure Vertex
        Dim x As Decimal
        Dim y As Decimal
        Dim z As Decimal
    End Structure

    Class SomeClass
        ' Add [In] or [In, Out] attributes as approppriate.
        ' Marshal as a C style array of Vertex, where the second (SizeParamIndex is zero-based)
        '  parameter (size) contains the count of array elements.

        Declare Auto Sub SomeUnsafeMethod Lib "somelib.dll" ( _
                                      <MarshalAs(UnmanagedType.LPArray, SizeParamIndex:=1)> data() As Vertex, _
                                      size As Long ) 

        Public Sub SomeMethod()
            Dim verts(3) As Vertex
            SomeUnsafeMethod( verts, verts.Length )
        End Sub

    End Class

End Namespace

Module Test
    Sub Main
        Dim AClass As New SomeClass

        AClass.SomeMethod
        End Sub
End Module

Keterangan

Bidang ini SizeParamIndex mendukung panggilan terkelola ke tidak terkelola dan tidak terkelola. Ini tidak berpengaruh pada kode terkelola yang memanggil objek COM.

Bergantung pada jenis terkelola dan atribut yang diterapkan padanya, array dapat diteruskan sebagai array aman atau array gaya C.

Saat array diteruskan sebagai array gaya C, marshaler tidak dapat menentukan ukuran array. Oleh karena itu, untuk meneruskan array terkelola ke fungsi atau metode yang tidak dikelola, Anda harus memberikan dua argumen:

• Array, ditentukan oleh referensi atau nilai.

• Ukuran array, ditentukan oleh referensi atau nilai.

Indeks berbasis nol dari parameter ukuran array ditentukan dengan menggunakan SizeParamIndex bidang .

Jika Anda menentukan dan SizeParamIndexMarshalAsAttribute.SizeConst dengan UnmanagedType.LPArray bidang, jumlah nilai bidang menghasilkan total ukuran.

Untuk informasi selengkapnya, lihat Marshaling Default untuk Array.

Lihat juga

• SizeConst
• LPArray