MarshalAsAttribute Classe

Definizione

public ref class MarshalAsAttribute sealed : Attribute

[System.AttributeUsage(System.AttributeTargets.Field | System.AttributeTargets.Parameter | System.AttributeTargets.ReturnValue, Inherited=false)]
public sealed class MarshalAsAttribute : Attribute

[System.AttributeUsage(System.AttributeTargets.Field | System.AttributeTargets.Parameter | System.AttributeTargets.ReturnValue, Inherited=false)]
[System.Runtime.InteropServices.ComVisible(true)]
public sealed class MarshalAsAttribute : Attribute

[<System.AttributeUsage(System.AttributeTargets.Field | System.AttributeTargets.Parameter | System.AttributeTargets.ReturnValue, Inherited=false)>]
type MarshalAsAttribute = class
    inherit Attribute

[<System.AttributeUsage(System.AttributeTargets.Field | System.AttributeTargets.Parameter | System.AttributeTargets.ReturnValue, Inherited=false)>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type MarshalAsAttribute = class
    inherit Attribute

Public NotInheritable Class MarshalAsAttribute
Inherits Attribute

Ereditarietà

Object

Attribute

MarshalAsAttribute

Attributi

AttributeUsageAttribute ComVisibleAttribute

Esempio

L'esempio seguente applica l'oggetto MarshalAsAttribute a un campo, un parametro del metodo e un valore restituito dal metodo in un tipo gestito.

using System;
using System.Text;
using System.Runtime.InteropServices;

class Program
{

//Applied to a parameter.
  public void M1([MarshalAs(UnmanagedType.LPWStr)]String msg) {}

//Applied to a field within a class.
  class MsgText {
                [MarshalAs(UnmanagedType.LPWStr)]
                public String msg = "Hello World";
                }

//Applied to a return value.
[return: MarshalAs(UnmanagedType.LPWStr)]
    public String GetMessage()
    {
        return "Hello World";
    }

static void Main(string[] args)
    {  }
}

Imports System.Runtime.InteropServices

Module Module1

    Sub Main()

    End Sub

    'Applied to a parameter.
    Public Sub M1(<MarshalAsAttribute(UnmanagedType.LPWStr)> ByVal msg As String)
        msg = msg + "Goodbye"
    End Sub

    'Applied to a field within a class.
    Class MsgText
        <MarshalAsAttribute(UnmanagedType.LPWStr)> Public msg As String
    End Class

    'Applied to a return value.
    Public Function M2() As <MarshalAsAttribute(UnmanagedType.LPWStr)> String
        Return "Hello World"
    End Function

End Module

L'esempio seguente applica l'attributo MarshalAsAttribute a una proprietà:

decimal _money;   

public decimal Money 
{
   [return: MarshalAs(UnmanagedType.Currency)]
   get { return this._money; }
   [param: MarshalAs(UnmanagedType.Currency)]
   set { this._money = value; }
}

Dim _money As Decimal   

Public Property Money As <MarshalAs(UnmanagedType.Currency)> Decimal 
   Get
      Return Me._money
   End Get
   Set(<MarshalAs(UnmanagedType.Currency)> value As Decimal)
      Me._money = value
   End Set   
End Property

Commenti

È possibile applicare questo attributo a parametri, campi o valori restituiti.

Questo attributo è facoltativo, poiché ogni tipo di dati ha un comportamento di marshalling predefinito. Questo attributo è necessario solo quando un determinato tipo può essere eseguito il marshalling su più tipi. Ad esempio, è possibile eseguire il marshalling di una stringa per il codice non gestito come LPStr, un LPWStr, o LPTStrun BStr. Per impostazione predefinita, Common Language Runtime esegue il marshalling di un parametro stringa come metodo BStr COM. È possibile applicare l'attributo MarshalAsAttribute a un singolo campo o parametro per causare il marshalling di tale stringa specifica come invece LPStr di un BStroggetto . L 'Tlbexp.exe (Type Library Exporter) passa le preferenze di marshalling al common language runtime.

Alcuni parametri e valori restituiti hanno un comportamento di marshalling predefinito diverso quando viene usato con l'interoperabilità COM o l'richiamare della piattaforma. Per impostazione predefinita, il runtime esegue il marshalling di un parametro stringa (e campi in un tipo di valore) come a un metodo o una LPStr funzione di richiamare la piattaforma. Per altre informazioni, vedere Comportamento di marshalling predefinito.

Nella maggior parte dei casi, l'attributo identifica semplicemente il formato dei dati non gestiti usando l'enumerazione UnmanagedType , come illustrato nella firma C# seguente:

public void SomeMethod([MarshalAs(UnmanagedType.LPStr)] String s)

Public Sub SomeMethod(<MarshalAs(UnmanagedType.LPStr)> s As String)

Alcuni UnmanagedType membri di enumerazione richiedono informazioni aggiuntive. Ad esempio, sono necessarie informazioni aggiuntive quando è UnmanagedTypeLPArray. Per una descrizione completa di come usare questo attributo con matrici, vedere Marshalling predefinito per matrici.

La Tlbimp.exe (Importazione libreria tipi) applica anche questo attributo ai parametri, ai campi e ai valori restituiti per indicare che il tipo di dati nella libreria dei tipi di input non è il tipo predefinito per il tipo di dati gestito corrispondente. Tlbimp.exe applica sempre i MarshalAsAttribute tipi a String e Object per chiarezza, indipendentemente dal tipo specificato nella libreria dei tipi di input.

Costruttori

Campi

Proprietà

Metodi

Implementazioni dell'interfaccia esplicita

Si applica a

Vedi anche

• UnmanagedType
• Esportazione libreria tipi (Tlbexp.exe)
• Tlbimp.exe (utilità di importazione della libreria dei tipi)