InAttribute Třída

Definice

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

Dědičnost

Object

Attribute

InAttribute

Atributy

AttributeUsageAttribute ComVisibleAttribute

Příklady

Následující příklad ukazuje, jak použít InAttribute a OutAttribute na prototyp vyvolání platformy, který předává pole jako parametr. Kombinace směrových atributů umožňuje volajícímu zobrazit změny provedené volanou.

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

Poznámky

Tento atribut můžete použít u parametrů.

Hodnota InAttribute je volitelná. Atribut je podporován pouze pro volání zprostředkovatele komunikace COM a platformy. Při absenci explicitního nastavení předpokládá zařazovač komunikace pravidla na základě typu parametru, zda je parametr předán odkazem nebo hodnotou a zda je typ blitelný nebo nerozbitelný. Například třída se vždy předpokládá, StringBuilder že je In/Out a pole řetězců předané hodnotou se předpokládá jako In.

Nelze použít InAttribute u parametru upraveného klíčovým slovem ve stylu jazyka out C#. Chcete-li zabránit záměně In klíčové slovo v jazyce Visual Basic s atributem InAttributeminus, použijte <[In]> formulář s hranatými závorkami kolem atributu.

Kombinace InAttribute a OutAttribute je zvlášť užitečná při použití u polí a formátovaných, nebližitelných typů. Volající uvidí změny, které volaný u těchto typů provede, jenom když použijete oba atributy. Vzhledem k tomu, že tyto typy vyžadují kopírování během zařazování, můžete použít InAttribute a OutAttribute ke snížení počtu nepotřebných kopií.

Další informace o vlivu InAttribute na chování zařazování naleznete v tématu Směrové atributy.

Konstruktory

Vlastnosti

Metody

Explicitní implementace rozhraní

Platí pro

Viz také

• OutAttribute
• StringBuilder
• Přenositelné a nepřenositelné typy