MarshalAsAttribute Třída

Definice

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

Dědičnost

Object

Attribute

MarshalAsAttribute

Atributy

AttributeUsageAttribute ComVisibleAttribute

Příklady

Následující příklad použije MarshalAsAttribute na pole, parametr metody a návratovou hodnotu metody ve spravovaném typu.

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

Následující příklad použije MarshalAsAttribute atribut na vlastnost:

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

Poznámky

Tento atribut můžete použít na parametry, pole nebo návratové hodnoty.

Tento atribut je volitelný, protože každý datový typ má výchozí chování zařazování. Tento atribut je nezbytný pouze v případě, že daný typ lze zařazovat do více typů. Řetězec můžete například zařadovat do nespravovaného kódu jako LPStr, LPWStr, , LPTStrnebo BStr. Modul CLR (Common Language Runtime) ve výchozím nastavení zařadí řetězcový parametr jako do BStr metod modelu COM. Atribut můžete použít MarshalAsAttribute na jednotlivá pole nebo parametr, aby se daný řetězec zařadil jako zařazovaný LPStr místo BStr. Tlbexp.exe (exportér knihovny typů) předá vaše předvolby zařazování do modulu CLR (Common Language Runtime).

Některé parametry a návratové hodnoty mají při použití s voláním zprostředkovatele komunikace com nebo platformy odlišné výchozí chování zařazování. Ve výchozím nastavení modul runtime zařadí řetězcový parametr (a pole typu hodnoty) jako metodu LPStr nebo funkci vyvolání platformy. Další informace najdete v tématu Výchozí chování zařazování.

Ve většině případů atribut jednoduše identifikuje formát nespravovaných dat pomocí výčtu UnmanagedType , jak je znázorněno v následujícím podpisu jazyka C#:

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

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

Některé UnmanagedType členy výčtu vyžadují další informace. Pokud je například hodnota UnmanagedTypeLPArray. Úplný popis použití tohoto atributu s poli naleznete v tématu Výchozí zařazování pro pole.

Tlbimp.exe (Type Library Importer) také použije tento atribut u parametrů, polí a návratových hodnot, aby bylo možné určit, že datový typ v knihovně vstupních typů není výchozím typem pro odpovídající spravovaný datový typ. Tlbimp.exe vždy pro přehlednost používá MarshalAsAttribute na String typy a Object bez ohledu na typ zadaný v knihovně vstupních typů.

Konstruktory

Pole

Vlastnosti

Metody

Explicitní implementace rozhraní

Platí pro

Viz také

• UnmanagedType
• Exportér knihovny typů (Tlbexp.exe)
• Import knihovny typů (Tlbimp.exe)