OutAttribute 類別

定義

命名空間:

System.Runtime.InteropServices

組件:

System.Runtime.dll

組件:

mscorlib.dll

組件:

netstandard.dll

表示資料應從被呼叫端封送處理至呼叫端。

public ref class OutAttribute sealed : Attribute

[System.AttributeUsage(System.AttributeTargets.Parameter, Inherited=false)]
public sealed class OutAttribute : Attribute

[System.AttributeUsage(System.AttributeTargets.Parameter, Inherited=false)]
[System.Runtime.InteropServices.ComVisible(true)]
public sealed class OutAttribute : Attribute

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

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

Public NotInheritable Class OutAttribute
Inherits Attribute

繼承

Object

Attribute

OutAttribute

屬性

AttributeUsageAttribute ComVisibleAttribute

範例

下列範例示範如何將 和 OutAttribute 套用 InAttribute 至平台叫用原型，以傳遞陣列做為參數。 方向屬性的組合可讓呼叫端查看被呼叫端所做的變更。

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

備註

您可以將此屬性套用至參數。

OutAttribute是選擇性的。 只有 COM Interop 和平臺叫用才支援 屬性。 如果沒有明確設定，Interop 封送處理器會根據參數類型、參數是以傳址方式或以值傳遞，以及類型是否為 blittable 或非 blittable 來假設規則。 例如， StringBuilder 類別一律假設為 In/Out，而以值傳遞的字串陣列假設為 In。

僅限輸出行為絕不是參數的預設封送處理行為。 您可以將 套用 OutAttribute 至以傳址方式傳遞的值和參考型別，將 In/Out 行為變更為僅限輸出行為，這相當於在 C# 中使用 out 關鍵字。 例如，依值傳遞的陣列預設會封送處理為僅限內部參數，可以變更為僅限 Out。 不過，當類型包含所有 blittable 元素或欄位時，行為不一定會提供預期的語意，因為 Interop 封送處理器使用釘選。 如果您不在意將資料傳遞至被呼叫者，僅限輸出封送處理可為非 Blittable 類型提供更好的效能。

結合 InAttribute 和 OutAttribute 在套用至陣列和格式化的非 Blittable 類型時特別有用。 呼叫端只有在套用這兩個屬性時，才會看到被呼叫者對這些類型的變更。 由於這些類型需要在封送處理期間複製，因此您可以使用 InAttribute 和 OutAttribute 來減少不必要的複本。

如需封送處理行為影響 OutAttribute 的詳細資訊，請參閱 方向屬性。

建構函式

OutAttribute()

初始化 OutAttribute 類別的新執行個體。

屬性

TypeId

在衍生類別中實作時，取得這個 Attribute 的唯一識別碼。 (繼承來源 Attribute)

方法

Equals(Object)	傳回值，這個值指出此執行個體是否與指定的物件相等。 (繼承來源 Attribute)
GetHashCode()	傳回這個執行個體的雜湊碼。 (繼承來源 Attribute)
GetType()	取得目前執行個體的 Type。 (繼承來源 Object)
IsDefaultAttribute()	在衍生類別中覆寫時，表示這個執行個體的值是衍生類別的預設值。 (繼承來源 Attribute)
Match(Object)	在衍生類別中覆寫時，會傳回值，表示這個執行個體是否等於指定物件。 (繼承來源 Attribute)
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
ToString()	傳回代表目前物件的字串。 (繼承來源 Object)

明確介面實作

_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)	將一組名稱對應至一組對應的分派識別項 (Dispatch Identifier)。 (繼承來源 Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)	擷取物件的類型資訊，可以用來取得介面的類型資訊。 (繼承來源 Attribute)
_Attribute.GetTypeInfoCount(UInt32)	擷取物件提供的類型資訊介面數目 (0 或 1)。 (繼承來源 Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)	提供物件所公開的屬性和方法的存取權。 (繼承來源 Attribute)

另請參閱

• InAttribute
• StringBuilder
• Blittable 和非 Blittable 類型