MarshalAsAttribute Klasse

Definition

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

Vererbung

Object

Attribute

MarshalAsAttribute

Attribute

AttributeUsageAttribute ComVisibleAttribute

Beispiele

Im folgenden Beispiel wird der MarshalAsAttribute auf ein Feld, einen Methodenparameter und einen Methodenrückgabewert in einem verwalteten Typ angewendet.

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

Im folgenden Beispiel wird das MarshalAsAttribute Attribut auf eine Eigenschaft angewendet:

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

Hinweise

Sie können dieses Attribut auf Parameter, Felder oder Rückgabewerte anwenden.

Dieses Attribut ist optional, da jeder Datentyp ein Standardmäßiges Marshallverhalten aufweist. Dieses Attribut ist nur erforderlich, wenn ein bestimmter Typ in mehrere Typen gemarst werden kann. Beispielsweise können Sie eine Zeichenfolge in nicht verwalteten Code als ein , ein LPStr, ein LPWStrLPTStroder ein marshallenBStr. Standardmäßig marshallt die Common Language Runtime einen Zeichenfolgenparameter als COM-Methoden BStr . Sie können das MarshalAsAttribute -Attribut auf ein einzelnes Feld oder Einen einzelnen Parameter anwenden, um zu bewirken, dass diese bestimmte Zeichenfolge als gemarst LPStr wird.BStr Der Tlbexp.exe (Type Library Exporter) übergibt Ihre Marshalleinstellungen an die Common Language Runtime.

Einige Parameter und Rückgabewerte weisen ein anderes Standard-Marshallverhalten auf, wenn sie mit COM-Interop oder Plattformaufrufen verwendet werden. Standardmäßig marshallt die Runtime einen Zeichenfolgenparameter (und Felder in einem Werttyp) als eine LPStr Plattformaufrufmethode oder -funktion. Weitere Informationen finden Sie unter Standard-Marshallverhalten.

In den meisten Fällen identifiziert das Attribut einfach das Format der nicht verwalteten Daten mithilfe der UnmanagedType Enumeration, wie in der folgenden C#-Signatur gezeigt:

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

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

Einige UnmanagedType Enumerationsmember erfordern zusätzliche Informationen. Beispielsweise sind zusätzliche Informationen erforderlich, wenn der UnmanagedType ist LPArray. Eine vollständige Beschreibung der Verwendung dieses Attributs mit Arrays finden Sie unter Standardmarschalling für Arrays.

Das Tlbimp.exe (Type Library Importer) wendet dieses Attribut auch auf Parameter, Felder und Rückgabewerte an, um anzugeben, dass der Datentyp in der Eingabetypbibliothek nicht der Standardtyp für den entsprechenden verwalteten Datentyp ist. Tlbimp.exe immer die MarshalAsAttribute Typen auf und Object anwenden, um String die Klarheit zu erzielen, unabhängig vom in der Eingabetypbibliothek angegebenen Typ.

Konstruktoren

Felder

Eigenschaften

Methoden

Explizite Schnittstellenimplementierungen

Gilt für:

Weitere Informationen

• UnmanagedType
• Typbibliotheksexporteur (Tlbexp.exe)
• Tlbimp.exe (Type Library Importer-Tool)