MarshalAsAttribute Klas

Definitie

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

Overname

Object

Attribute

MarshalAsAttribute

Kenmerken

AttributeUsageAttribute ComVisibleAttribute

Voorbeelden

In het volgende voorbeeld wordt het MarshalAsAttribute toegepast op een veld, een methodeparameter en een methode retourwaarde in een beheerd type.

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

In het volgende voorbeeld wordt het MarshalAsAttribute kenmerk toegepast op een eigenschap:

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

Opmerkingen

U kunt dit kenmerk toepassen op parameters, velden of retourwaarden.

Dit kenmerk is optioneel, omdat elk gegevenstype een standaard marshaling-gedrag heeft. Dit kenmerk is alleen nodig wanneer een bepaald type kan worden marshaled aan meerdere typen. U kunt bijvoorbeeld een tekenreeks naar onbeheerde code heffen als een LPStr, a LPWStr, a LPTStrof een BStr. De algemene taalruntime marshals standaard een tekenreeksparameter als com-methoden BStr . U kunt het MarshalAsAttribute kenmerk toepassen op een afzonderlijk veld of een afzonderlijke parameter om ervoor te zorgen dat die bepaalde tekenreeks wordt marshaled als een LPStr in plaats van een BStr. De Tlbexp.exe (Type Library Exporter) geeft uw marshaling-voorkeuren door aan de algemene taalruntime.

Sommige parameters en retourwaarden hebben een ander standaard marshalinggedrag wanneer deze worden gebruikt met COM-interop- of platformaanroepen. De runtime marshals standaard een tekenreeksparameter (en velden in een waardetype) als een LPStr platform-aanroepmethode of -functie. Zie Default Marshaling Behavior voor meer informatie.

In de meeste gevallen identificeert het kenmerk eenvoudig de indeling van de niet-beheerde gegevens met behulp van de UnmanagedType opsomming, zoals wordt weergegeven in de volgende C#-handtekening:

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

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

Voor sommige UnmanagedType inventarisatieleden is aanvullende informatie vereist. Er is bijvoorbeeld aanvullende informatie nodig wanneer dit UnmanagedType het is LPArray. Zie Default Marshaling for Arrays voor een volledige beschrijving van het gebruik van dit kenmerk met matrices.

Het Tlbimp.exe (Type Bibliotheekimporteur) past dit kenmerk ook toe op parameters, velden en retourwaarden om aan te geven dat het gegevenstype in de invoertypebibliotheek niet het standaardtype is voor het bijbehorende beheerde gegevenstype. Tlbimp.exe altijd van MarshalAsAttributeString toepassing op en Object typen voor duidelijkheid, ongeacht het type dat is opgegeven in de invoertypebibliotheek.

Zie ook

• UnmanagedType
• Type bibliotheekexporteur (Tlbexp.exe)
• Type Bibliotheekimporteur (Tlbimp.exe)