MarshalAsAttribute.SizeParamIndex Field

Definition

Указывает параметр, содержащий отсчитываемое от нуля количество элементов массива, аналогичный параметру size_is в COM.Indicates the zero-based parameter that contains the count of array elements, similar to size_is in COM.

public: short SizeParamIndex;
public short SizeParamIndex;
val mutable SizeParamIndex : int16
Public SizeParamIndex As Short 

Field Value

Int16

Examples

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

Remarks

Поле SizeParamIndex поддерживает вызовы между управляемым и неуправляемым вызовами.The SizeParamIndex field supports managed-to-unmanaged and unmanaged-to-managed calls. Он не влияет на управляемый код, который вызывает COM-объекты.It does not have any effect on managed code that calls COM objects.

В зависимости от управляемого типа и примененных к нему атрибутов массив можно передать в качестве безопасного массива или массива в стиле C.Depending on the managed type and the attributes applied to it, the array can be passed as a safe array or C-style array.

Когда массивы передаются как массивы в стиле C, маршалеру не удается определить размер массива.When arrays are passed as C-style arrays, the marshaler cannot determine the size of the array. Таким образом, для передачи управляемого массива в неуправляемую функцию или метод необходимо указать два аргумента:Therefore, to pass an managed array to an unmanaged function or method, you must provide two arguments:

  • Массив, определенный по ссылке или значению.The array, defined by reference or value.

  • Размер массива, определенный по ссылке или значению.The array size, defined by reference or value.

Отсчитываемый от нуля индекс параметра размера массива определяется с помощью поля SizeParamIndex.The zero-based index of the array size parameter is defined by using the SizeParamIndex field.

Если указать как SizeParamIndex, так и MarshalAsAttribute.SizeConst с полем UnmanagedType.LPArray, сумма значений полей будет равна общему размеру.If you specify both SizeParamIndex and MarshalAsAttribute.SizeConst with a UnmanagedType.LPArray field, the sum of the fields' values produces a size total.

Дополнительные сведения см. в разделе маршалирование по умолчанию для массивов.For more information, see Default Marshaling for Arrays.

Applies to

See also