MarshalAsAttribute Sınıf

Tanım

Ad Alanı:

System.Runtime.InteropServices

Bütünleştirilmiş Kod:

System.Runtime.InteropServices.dll

Kaynak:

MarshalAsAttribute.cs

Yönetilen ve yönetilmeyen kod arasında verilerin nasıl sıralanacaklarını gösterir.

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)>]
type MarshalAsAttribute = class
    inherit Attribute

Public NotInheritable Class MarshalAsAttribute
Inherits Attribute

Devralma

Object

Attribute

MarshalAsAttribute

Öznitelikler

AttributeUsageAttribute

Ö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.

Not

, MarshalAsAttribute genel türlerin sıralanmasını desteklemez.

Oluşturucular

MarshalAsAttribute(Int16)	Belirtilen UnmanagedType değerle sınıfının yeni bir örneğini MarshalAsAttribute başlatır.
MarshalAsAttribute(UnmanagedType)	Belirtilen UnmanagedType numaralandırma üyesiyle sınıfının yeni bir örneğini MarshalAsAttribute başlatır.

Alanlar

ArraySubType	Yönetilmeyen LPArray veya ByValArrayöğesinin öğe türünü belirtir.
IidParameterIndex	COM tarafından kullanılan yönetilmeyen iid_is özniteliğin parametre dizinini belirtir.
MarshalCookie	Özel bir sıralayıcıya ek bilgi sağlar.
MarshalType	Özel bir sıralayıcının tam adını belirtir.
MarshalTypeRef	Tür olarak uygular MarshalType .
SafeArraySubType	öğesinin öğe türünü SafeArraygösterir.
SafeArrayUserDefinedSubType	kullanıcı tanımlı öğesinin SafeArraytürünü gösterir.
SizeConst	Sabit uzunlukta dizideki öğelerin sayısını veya içeri aktaracak dizedeki karakter sayısını (bayt değil) gösterir.
SizeParamIndex	DIZI öğelerinin sayısını içeren, COM'dakine benzer sıfır tabanlı parametreyi size_is gösterir.

Özellikler

TypeId	Türetilmiş bir sınıfta uygulandığında, bu Attributeiçin benzersiz bir tanımlayıcı alır. (Devralındığı yer: Attribute)
Value	UnmanagedType Verilerin olarak sıralanması gereken değeri alır.

Yöntemler

Equals(Object)	Bu örneğin belirtilen bir nesneye eşit olup olmadığını gösteren bir değeri döndürür. (Devralındığı yer: Attribute)
GetHashCode()	Bu örneğe ilişkin karma kodu döndürür. (Devralındığı yer: Attribute)
GetType()	Type Geçerli örneğini alır. (Devralındığı yer: Object)
IsDefaultAttribute()	Türetilmiş bir sınıfta geçersiz kılındığında, bu örneğin değerinin türetilmiş sınıf için varsayılan değer olup olmadığını gösterir. (Devralındığı yer: Attribute)
Match(Object)	Türetilmiş bir sınıfta geçersiz kılındığında, bu örneğin belirtilen bir nesneye eşit olup olmadığını gösteren bir değer döndürür. (Devralındığı yer: Attribute)
MemberwiseClone()	Geçerli Objectöğesinin sığ bir kopyasını oluşturur. (Devralındığı yer: Object)
ToString()	Geçerli nesneyi temsil eden dizeyi döndürür. (Devralındığı yer: Object)

Ayrıca bkz.

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