InAttribute Класс

Определение

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

Наследование

Object

Attribute

InAttribute

Атрибуты

AttributeUsageAttribute ComVisibleAttribute

Примеры

В следующем примере показано, как применить InAttribute и OutAttribute к прототипу вызова платформы, который передает массив в качестве параметра. Сочетание атрибутов направления позволяет вызывающей стороне видеть изменения, внесенные вызываемым.

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

Комментарии

Этот атрибут можно применить к параметрам.

Является InAttribute необязательным. Атрибут поддерживается только для COM-взаимодействия и вызова платформы. При отсутствии явных параметров маршалер взаимодействия предполагает правила, основанные на типе параметра, передается ли параметр по ссылке или значению, а также является ли тип blittable или non-blittable. Например, StringBuilder класс всегда предполагается как In/Out, а массив строк, передаваемых по значению, — как In.

Нельзя применить InAttribute к параметру, измененном с помощью ключевого слова в стиле out C#. Чтобы избежать путаницы ключевого In слова в Visual Basic с InAttribute, минус Атрибут, используйте <[In]> форму с квадратными скобками вокруг атрибута.

InAttribute Объединение и OutAttribute особенно полезно при применении к массивам и форматированным, непреобразуемым типам. Вызывающие стороны видят изменения, которые вызывающий объект вносит в эти типы только при применении обоих атрибутов. Так как эти типы требуют копирования во время маршалинга, можно использовать InAttribute и OutAttribute для сокращения ненужных копий.

Дополнительные сведения о влиянии InAttribute на поведение маршалинга см. в разделе Атрибуты направления.

Конструкторы

Свойства

Методы

Явные реализации интерфейса

Применяется к

См. также раздел

• OutAttribute
• StringBuilder
• Преобразуемые и непреобразуемые типы