MarshalAsAttribute Sınıf

Tanım

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

Devralma

Object

Attribute

MarshalAsAttribute

Öznitelikler

AttributeUsageAttribute ComVisibleAttribute

Örnekler

Aşağıdaki örnek bir alana, yöntem parametresine ve yönetilen türdeki bir yöntem dönüş değerine uygular MarshalAsAttribute .

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

Aşağıdaki örnek özniteliğini bir özelliğe uygular MarshalAsAttribute :

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

Açıklamalar

Bu özniteliği parametrelere, alanlara veya dönüş değerlerine uygulayabilirsiniz.

Her veri türünün varsayılan hazırlama davranışı olduğundan bu öznitelik isteğe bağlıdır. Bu öznitelik yalnızca belirli bir tür birden çok türe sıralanabilirse gereklidir. Örneğin, yönetilmeyen koda bir dizeyi , LPWStrLPTStrveya BStrolarak LPStrsıralayabilirsiniz. Varsayılan olarak, ortak dil çalışma zamanı bir dize parametresini COM yöntemleri olarak BStr sıralar. Özniteliğini MarshalAsAttribute tek bir alana veya parametreye uygulayarak söz konusu dizenin yerine BStrolarak LPStr sıralanmasına neden olabilirsiniz. Tlbexp.exe (Tür Kitaplığı Dışarı Aktarıcısı), hazırlama tercihlerinizi ortak dil çalışma zamanına geçirir.

Bazı parametreler ve dönüş değerleri, COM birlikte çalışma veya platform çağırma ile kullanıldığında farklı varsayılan hazırlama davranışına sahiptir. Varsayılan olarak, çalışma zamanı bir dize parametresini (ve değer türündeki alanları) LPStr platform çağırma yöntemine veya işlevine sıralar. Ek bilgi için bkz . Varsayılan Hazırlama Davranışı.

Çoğu durumda özniteliği, aşağıdaki C# imzasında gösterildiği gibi numaralandırmayı UnmanagedType kullanarak yönetilmeyen verilerin biçimini tanımlar:

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

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

Bazı UnmanagedType numaralandırma üyeleri ek bilgi gerektirir. Örneğin, olduğunda ek bilgi gerekir UnmanagedTypeLPArray. Bu özniteliğin dizilerle nasıl kullanılacağının tam açıklaması için bkz . Diziler için Varsayılan Hazırlama.

Tlbimp.exe (Tür Kitaplığı İçeri Aktarıcısı), giriş türü kitaplığındaki veri türünün ilgili yönetilen veri türü için varsayılan tür olmadığını belirtmek için bu özniteliği parametrelere, alanlara ve dönüş değerlerine de uygular. Tlbimp.exe her zaman giriş türü kitaplığında MarshalAsAttributeStringObject belirtilen türe bakılmaksızın ve türlerini netlik için uygular.

Oluşturucular

Alanlar

Özellikler

Yöntemler

Belirtik Arabirim Kullanımları

Şunlara uygulanır

Ayrıca bkz.

• UnmanagedType
• Tür Kitaplığı Dışarı Aktarıcısı (Tlbexp.exe)
• Tür Kitaplığı İçeri Aktarıcısı (Tlbimp.exe)