共用方式為


方向屬性

更新:2007 年 11 月

每一個方法參數都可以與 InAttribute 屬性、OutAttribute 屬性或兩者的設定產生關聯。您可以在設計階段套用方向屬性,修改 Managed 和 Unmanaged 記憶體之間的 Run-Time 封送處理。

InAttributeOutAttribute 是位於 System.Runtime.InteropServices 命名空間中,而且相當於介面定義語言 (IDL) 的介面屬性 [in][out][in/out][out, retval]

注意事項:

Managed 方法簽章 (Signature) 的傳回值永遠會對應至型別程式庫中的 [out, retval]。沒有您可以套用的對等方向屬性。

方向屬性是選擇性的。當您想要更改封送處理器的預設行為時,可以將方向屬性套用至方法參數中。如果省略方法參數中的方向屬性,封送處理器會根據參數的型別 (數值或參考) 和其修飾詞 (Modifier) (如果有的話),決定方向性流動。

某些語言提供關鍵字,可以讓您修改方法參數的方向性流動。下表列出 Visual Basic 2005 和 C# 所提供與方向相關的關鍵字,並顯示對等的 IDL 介面屬性。

Visual Basic 2005

C#

IDL 屬性

ByVal

沒有對等用法。

[in]

ByRef

ref

[in/out]

沒有對等用法。

out

[out]

ByRefrefout 參數修飾詞 (Modifier) 會使得方法引數以傳址 (By Reference) 方式進行封送處理,而非使用傳值 (By Value) 方式。以傳值方式傳遞的方法引數會封送處理至 Unmanaged 程式碼做為堆疊上的值;而以傳址方式傳遞的引數會封送處理為堆疊上的指標。下圖顯示具有參數修飾詞的實值型別 (Value Type) 和參考型別 (Reference Type) 之預設的封送處理行為。

Unmanaged 程式碼的方法引數之預設封送處理

預設的封送處理行為

由於效能因素,以傳值方式傳遞的參考型別 (類別、陣列、字串和介面) 會預設封送處理為 In 參數。除非您將 InAttributeOutAttribute (或 OutAttribute) 套用至方法參數,否則不會看到這些型別的變更。StringBuilder 類別,是這個規則的例外,會封送處理為 In/Out 參數。

關於方向屬性,Interop 封送處理器將保證以下行為:

  • Interop 封送處理器並不會產生從 Unmanaged 程式碼傳遞而來的 In 參數的寫入作業。因此,Unmanaged 程式碼可以安全地將指標傳遞給唯讀頁面,或將指標傳遞給目前存取的資料。

  • 當複製的物件包含配置的物件 (例如 BSTR) 時,封送處理器永遠會執行正確的配置順序和 In/Out 設定所需要的解構。

精確無誤地在您的程式碼中套用方向屬性是非常重要的。在 Managed 程式碼中正確地將 InAttributeOutAttribute 套用至參數,可確保型別程式庫匯出工具 (Tlbexp.exe) 在對應的型別程式庫中使用這些位元來設定 In/Out 位元;這對可以 Pin (如某些陣列和類別) 的參考型別特別重要。

請參閱

概念

使用 Interop 封送處理器的記憶體管理

Blittable 和非 Blittable 型別

複製和 Pin

其他資源

預設的封送處理行為