InAttribute Osztály

Definíció

Névtér:

System.Runtime.InteropServices

Szerelvények:

netstandard.dll, System.Runtime.dll

Forrás:

InAttribute.cs

Azt jelzi, hogy az adatokat a hívótól a hívóhoz kell átirányítani, de a hívóhoz nem.

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

Öröklődés

Object

Attribute

InAttribute

Attribútumok

AttributeUsageAttribute

Példák

Az alábbi példa bemutatja, hogyan alkalmazhatja a InAttribute tömböt paraméterként áthaladó prototípust és OutAttribute platformhívást. Az irányattribútumok kombinációja lehetővé teszi, hogy a hívó lássa a hívó által végrehajtott módosításokat.

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

Megjegyzések

Ezt az attribútumot a paraméterekre is alkalmazhatja.

Ez InAttribute nem kötelező. Az attribútum csak com-interop és platformhívás esetén támogatott. Explicit beállítások hiányában az interop marshaler a paraméter típusa alapján feltételezi a szabályokat, hogy a paraméter hivatkozással vagy érték alapján van-e átadva, és hogy a típus titkos vagy nem titkos. Az osztály például mindig in/out értéket feltételez, StringBuilder és az érték által átadott sztringek tömbje in értéknek számít.

A C#-stílusú InAttribute kulcsszóval módosított paraméterre nem alkalmazhatóout. A In kulcsszó Visual Basic InAttribute mínusz attribútummal való összekeverésének elkerülése érdekében használja a <[In]> űrlapot zárójelekkel az attribútum körül.

InAttribute OutAttribute A tömbök és a formázott, nem titkos típusok együttes alkalmazása különösen hasznos. A hívók csak akkor látják az ilyen típusok módosításait, ha mindkét attribútumot alkalmazza. Mivel ezek a típusok másolást igényelnek a marshaling során, használhatja InAttribute és OutAttribute csökkentheti a szükségtelen másolatokat.

A marshaling viselkedésére InAttribute gyakorolt hatásról további információt az Irányított attribútumok című témakörben talál.

Konstruktorok

Name	Description
InAttribute()	Inicializálja a InAttribute osztály új példányát.

Tulajdonságok

Name	Description
TypeId	Ha származtatott osztályban implementálják, ehhez egy egyedi azonosítót Attributekap. (Öröklődés forrása Attribute)

Metódusok

Name	Description
Equals(Object)	Olyan értéket ad vissza, amely jelzi, hogy ez a példány egyenlő-e egy adott objektummal. (Öröklődés forrása Attribute)
GetHashCode()	A példány kivonatkódját adja vissza. (Öröklődés forrása Attribute)
GetType()	Lekéri az Type aktuális példányt. (Öröklődés forrása Object)
IsDefaultAttribute()	Ha egy származtatott osztályban felül van bírálva, azt jelzi, hogy a példány értéke-e a származtatott osztály alapértelmezett értéke. (Öröklődés forrása Attribute)
Match(Object)	Származtatott osztály felülírásakor egy olyan értéket ad vissza, amely jelzi, hogy ez a példány egy adott objektummal egyenlő-e. (Öröklődés forrása Attribute)
MemberwiseClone()	Az aktuális Objectpéldány sekély másolatát hozza létre. (Öröklődés forrása Object)
ToString()	Az aktuális objektumot jelképező sztringet ad vissza. (Öröklődés forrása Object)

Lásd még

• OutAttribute
• StringBuilder
• Blittable és nem-Blittable típusok