InAttribute Clase

Definición

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

Herencia

Object

Attribute

InAttribute

Atributos

AttributeUsageAttribute ComVisibleAttribute

Ejemplos

En el ejemplo siguiente se muestra cómo aplicar y InAttributeOutAttribute a un prototipo de invocación de plataforma que pasa una matriz como parámetro. La combinación de atributos direccionales permite al autor de la llamada ver los cambios realizados por el destinatario.

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

Comentarios

Puede aplicar este atributo a parámetros.

InAttribute es opcional. El atributo solo se admite para la interoperabilidad COM y la invocación de plataforma. En ausencia de configuraciones explícitas, el serializador de interoperabilidad asume las reglas basadas en el tipo de parámetro, si el parámetro se pasa por referencia o por valor, y si el tipo es de tabla de bits o no blittable. Por ejemplo, siempre se supone que la StringBuilder clase es In/Out y se supone que una matriz de cadenas pasadas por valor es In.

No se puede aplicar a InAttribute un parámetro modificado con la palabra clave con estilo out C#. Para evitar confundir la In palabra clave en Visual Basic con InAttributeel atributo , menos Attribute, use el <[In]> formulario con corchetes alrededor del atributo.

Combinar y InAttributeOutAttribute es especialmente útil cuando se aplica a matrices y tipos con formato no blittable. Los autores de llamadas ven los cambios que realiza un destinatario en estos tipos solo cuando se aplican ambos atributos. Dado que estos tipos requieren copiar durante la serialización, puede usar InAttribute y OutAttribute reducir las copias innecesarias.

Para obtener más información sobre el efecto de en el comportamiento de InAttribute serialización, vea Atributos direccionales.

Constructores

Propiedades

Métodos

Implementaciones de interfaz explícitas

Se aplica a

Consulte también

• OutAttribute
• StringBuilder
• Tipos que pueden o que no pueden transferirse en bloque de bits