InAttribute Klasse

Definition

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)]
[System.Runtime.InteropServices.ComVisible(true)]
public sealed class InAttribute : Attribute

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

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

Public NotInheritable Class InAttribute
Inherits Attribute

Vererbung

Object

Attribute

InAttribute

Attribute

AttributeUsageAttribute ComVisibleAttribute

Beispiele

Das folgende Beispiel zeigt, wie und OutAttribute auf einen Plattformaufrufprototyp angewendet InAttribute wird, der ein Array als Parameter übergibt. Die Kombination von direktionalen Attributen ermöglicht es dem Aufrufer, die vom Angerufenen vorgenommenen Änderungen anzuzeigen.

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

Hinweise

Sie können dieses Attribut auf Parameter anwenden.

Ist InAttribute optional. Das Attribut wird nur für COM-Interop und Plattformaufrufe unterstützt. Wenn keine expliziten Einstellungen vorhanden sind, geht der Interop-Marshaller von Regeln aus, die auf dem Parametertyp basieren, unabhängig davon, ob der Parameter als Verweis oder wert übergeben wird und ob der Typ blittbar oder nicht blittbar ist. Beispielsweise wird angenommen, dass die StringBuilder Klasse immer In/Out ist, und ein Array von Zeichenfolgen, die als Wert übergeben werden, wird als In angenommen.

Sie können die InAttribute nicht auf einen Parameter anwenden, der mit dem C#-formatierten Schlüsselwort (keyword) geändert wurde out . Verwenden Sie <[In]> das In Formular mit Klammern um das Attribut, um die Schlüsselwort (keyword) in Visual Basic mit dem InAttributeAttribut minus zu verwechseln.

Die Kombination von InAttribute und OutAttribute ist besonders nützlich, wenn sie auf Arrays und formatierte, nicht blittbare Typen angewendet wird. Aufrufer sehen die Änderungen, die ein Angerufener an diesen Typen vornimmt, nur wenn Sie beide Attribute anwenden. Da diese Typen während des Marshallings kopieren müssen, können Sie und OutAttribute verwendenInAttribute, um unnötige Kopien zu reduzieren.

Weitere Informationen zu den Auswirkungen von InAttribute auf das Marshallingverhalten finden Sie unter Direktionale Attribute.

Konstruktoren

Eigenschaften

Methoden

Explizite Schnittstellenimplementierungen

Gilt für:

Weitere Informationen

• OutAttribute
• StringBuilder
• Blitfähige und nicht blitfähige Typen