MarshalAsAttribute.SizeParamIndex Campo

Definizione

Spazio dei nomi:

System.Runtime.InteropServices

Assembly:

netstandard.dll, System.Runtime.InteropServices.dll

Origine:

MarshalAsAttribute.cs

Indica il parametro in base zero che contiene il numero di elementi della matrice, come size_is in COM.

C#

public short SizeParamIndex;

Valore del campo

Int16

Esempio

C#

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

Commenti

Il SizeParamIndex campo supporta chiamate gestite da non gestite e non gestite. Non ha alcun effetto sul codice gestito che chiama oggetti COM.

A seconda del tipo gestito e degli attributi applicati, la matrice può essere passata come matrice sicura o matrice in stile C.

Quando le matrici vengono passate come matrici in stile C, il marshalling non può determinare le dimensioni della matrice. Pertanto, per passare una matrice gestita a una funzione o a un metodo non gestito, è necessario specificare due argomenti:

• Matrice definita da riferimento o valore.

• Dimensioni della matrice definite da riferimento o valore.

L'indice in base zero del parametro delle dimensioni della matrice viene definito usando il SizeParamIndex campo .

Se si specificano entrambi SizeParamIndex e MarshalAsAttribute.SizeConst con un campo, la somma dei valori dei campi produce un UnmanagedType.LPArray totale di dimensioni.

Per altre informazioni, vedere Marshalling predefinito per le matrici.

Si applica a

Vedi anche

• SizeConst
• LPArray