InAttribute Klas

Definitie

Naamruimte:

System.Runtime.InteropServices

Assembly's:

netstandard.dll, System.Runtime.dll

Bron:

InAttribute.cs

Hiermee wordt aangegeven dat gegevens van de beller naar de beller moeten worden gespoeld, maar niet terug naar de beller.

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

Overname

Object

Attribute

InAttribute

Kenmerken

AttributeUsageAttribute

Voorbeelden

In het volgende voorbeeld ziet u hoe u het InAttribute en OutAttribute op een platform aanroept prototype waarmee een matrix als parameter wordt doorgegeven. Met de combinatie van directionele kenmerken kan de aanroeper de wijzigingen zien die door de aanroeper zijn aangebracht.

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

Opmerkingen

U kunt dit kenmerk toepassen op parameters.

De InAttribute optie is optioneel. Het kenmerk wordt alleen ondersteund voor COM-interop- en platformoproepen. Als er geen expliciete instellingen zijn, gaat de interop marshaler uit van regels op basis van het parametertype, of de parameter wordt doorgegeven door verwijzing of op waarde, en of het type belicht of niet-belichtbaar is. De klasse wordt bijvoorbeeld StringBuilder altijd in/uit genomen en een matrix met tekenreeksen die door de waarde worden doorgegeven, wordt verondersteld in te zijn.

U kunt de InAttribute parameter niet toepassen op een parameter die is gewijzigd met het trefwoord in C#-stijl out . Gebruik het formulier In met vierkante haken rond het kenmerk om verwarrend te voorkomen dat het trefwoord InAttribute in Visual Basic met het <[In]>.

Het combineren van de InAttribute en OutAttribute is met name handig wanneer deze wordt toegepast op matrices en opgemaakte, niet-belichte typen. Bellers zien alleen de wijzigingen die een gebruiker aanbrengt in deze typen wanneer u beide kenmerken toepast. Aangezien deze typen kopiëren tijdens marshaling vereisen, kunt u onnodige kopieën gebruiken InAttribute en OutAttribute verminderen.

Zie InAttribute voor meer informatie over het effect van marshaling behavior.

Constructors

Name	Description
InAttribute()	Initialiseert een nieuw exemplaar van de InAttribute klasse.

Eigenschappen

Name	Description
TypeId	Wanneer deze wordt geïmplementeerd in een afgeleide klasse, krijgt u Attributehiervoor een unieke id. (Overgenomen van Attribute)

Methoden

Name	Description
Equals(Object)	Retourneert een waarde die aangeeft of dit exemplaar gelijk is aan een opgegeven object. (Overgenomen van Attribute)
GetHashCode()	Retourneert de hash-code voor dit exemplaar. (Overgenomen van Attribute)
GetType()	Hiermee haalt u de Type huidige instantie op. (Overgenomen van Object)
IsDefaultAttribute()	Wanneer deze wordt overschreven in een afgeleide klasse, geeft u aan of de waarde van dit exemplaar de standaardwaarde is voor de afgeleide klasse. (Overgenomen van Attribute)
Match(Object)	Wanneer deze wordt overschreven in een afgeleide klasse, wordt een waarde geretourneerd die aangeeft of dit exemplaar gelijk is aan een opgegeven object. (Overgenomen van Attribute)
MemberwiseClone()	Hiermee maakt u een ondiepe kopie van de huidige Object. (Overgenomen van Object)
ToString()	Retourneert een tekenreeks die het huidige object vertegenwoordigt. (Overgenomen van Object)

Zie ook

• OutAttribute
• StringBuilder
• Blittable- en niet-Blittable-typen