InAttribute Kelas

Definisi

Ruang nama:

System.Runtime.InteropServices

Rakitan:

System.Runtime.dll

Sumber:

InAttribute.cs

Menunjukkan bahwa data harus dinamai dari penelepon ke penerima panggilan, tetapi tidak kembali ke pemanggil.

public ref class InAttribute sealed : Attribute

[System.AttributeUsage(System.AttributeTargets.Parameter, Inherited=false)]
public sealed class InAttribute : Attribute

[<System.AttributeUsage(System.AttributeTargets.Parameter, Inherited=false)>]
type InAttribute = class
    inherit Attribute

Public NotInheritable Class InAttribute
Inherits Attribute

Warisan

Object

Attribute

InAttribute

Atribut

AttributeUsageAttribute

Contoh

Contoh berikut menunjukkan cara menerapkan InAttribute dan OutAttribute ke platform memanggil prototipe yang meneruskan array sebagai parameter. Kombinasi atribut arah memungkinkan pemanggil untuk melihat perubahan yang dibuat oleh penerima panggilan.

using namespace System;
using namespace System::Runtime::InteropServices;

// Declare a class member for each structure element.

[StructLayout(LayoutKind::Sequential, CharSet = CharSet::Unicode)]
public ref class OpenFileName
{
public:
    int structSize;
    String^ filter;
    String^ file;
    // ...
};

private ref class NativeMethods
{
public:

    // Declare a managed prototype for the unmanaged function.

    [DllImport("Comdlg32.dll", CharSet = CharSet::Unicode)]
    static bool GetOpenFileName([In, Out]OpenFileName^ ofn);
};

void main() {}

using System.Runtime.InteropServices;
using System;

// Declare a class member for each structure element.
[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public class OpenFileName
{
    public int structSize = 0;
    public string filter = null;
    public string file = null;
    // ...
}

internal static class NativeMethods
{
    // Declare a managed prototype for the unmanaged function.
    [DllImport("Comdlg32.dll", CharSet = CharSet.Unicode)]
    internal static extern bool GetOpenFileName([In, Out] OpenFileName ofn);
}

public class MainMethod
{
    static void Main()
    { }
}

Imports System.Runtime.InteropServices

' Declare a class member for each structure element.
<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Class OpenFileName

    Public structSize As Integer = 0
    Public filter As String = Nothing
    Public file As String = Nothing
    ' ...

End Class

Friend Class NativeMethods
    ' Declare managed prototype for the unmanaged function.
    Friend Declare Unicode Function GetOpenFileName Lib "Comdlg32.dll" (
       <[In](), Out()> ByVal ofn As OpenFileName) As Boolean
End Class

Public Class App
    Public Shared Sub Main()

    End Sub
End Class

Keterangan

Anda dapat menerapkan atribut ini ke parameter.

InAttribute bersifat opsional. Atribut ini hanya didukung untuk interop COM dan platform yang dipanggil. Dengan tidak adanya pengaturan eksplisit, marshaler interop mengasumsikan aturan berdasarkan jenis parameter, apakah parameter diteruskan oleh referensi atau berdasarkan nilai, dan apakah jenisnya dapat diputar atau tidak dapat diputuskan. Misalnya, StringBuilder kelas selalu diasumsikan sebagai Masuk/Keluar dan array string yang diteruskan oleh nilai diasumsikan masuk.

Anda tidak dapat menerapkan ke InAttribute parameter yang dimodifikasi out dengan kata kunci bergaya C#. Untuk menghindari membingungkan In kata kunci di Visual Basic dengan InAttribute, minus Atribut, gunakan <[In]> formulir dengan tanda kurung di sekitar atribut.

InAttribute Menggabungkan dan OutAttribute sangat berguna saat diterapkan ke array dan jenis yang diformat dan tidak dapat di-blittable. Penelepon melihat perubahan yang dilakukan penerima panggilan pada jenis ini hanya saat Anda menerapkan kedua atribut. Karena jenis ini memerlukan penyalinan selama marshaling, Anda dapat menggunakan InAttribute dan OutAttribute untuk mengurangi salinan yang tidak perlu.

Untuk informasi selengkapnya tentang efek InAttribute perilaku marshaling, lihat Atribut Arah.

Konstruktor

InAttribute()

Menginisialisasi instans baru kelas InAttribute.

Properti

TypeId

Ketika diimplementasikan di kelas turunan, mendapatkan pengidentifikasi unik untuk ini Attribute. (Diperoleh dari Attribute)

Metode

Equals(Object)	Mengembalikan nilai yang menunjukkan apakah instans ini sama dengan objek tertentu. (Diperoleh dari Attribute)
GetHashCode()	Mengembalikan kode hash untuk instans ini. (Diperoleh dari Attribute)
GetType()	Mendapatkan dari instans Type saat ini. (Diperoleh dari Object)
IsDefaultAttribute()	Ketika ditimpa di kelas turunan, menunjukkan apakah nilai instans ini adalah nilai default untuk kelas turunan. (Diperoleh dari Attribute)
Match(Object)	Saat ditimpa di kelas turunan, mengembalikan nilai yang menunjukkan apakah instans ini sama dengan objek tertentu. (Diperoleh dari Attribute)
MemberwiseClone()	Membuat salinan dangkal dari saat ini Object. (Diperoleh dari Object)
ToString()	Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object)

Lihat juga

• OutAttribute
• StringBuilder
• Jenis Blittable dan Non-Blittable