interface class
(C++/CLI 和C++/CX)
宣告介面。 如需原生介面的資訊,請參閱 __interface
。
所有運行時間
語法
interface_access interface class name : inherit_access base_interface {};
interface_access interface struct name : inherit_access base_interface {};
參數
interface_access
介面在組件外部的可及性。 可能的值是 public
和 private
。 private
是預設值。 巢狀介面不能有 interface_access
規範。
name
介面的名稱。
inherit_access
的 base_interface
輔助功能。 基底介面的唯一允許存取範圍是 public
(預設值)。
base_interface
(選擇性)介面 的 name
基底介面。
備註
interface struct
等於 interface class
。
介面可以包含函式、事件和屬性的宣告。 所有介面成員都具有 public 可及性。 介面也可以包含靜態資料成員、函式、事件和屬性,而且這些靜態成員都必須定義於介面中。
介面會定義可能要如何實作類別的方式。 介面不是類別,而且類別只能實作介面。 如果類別會定義介面中所宣告的函式,就會實作該函式,而不會覆寫。 因此,名稱查閱不包含介面成員。
class
或 struct
衍生自 介面的 ,必須實作介面的所有成員。 實作介面 name
時,您也必須在清單中實作 base_interface
介面。
如需詳細資訊,請參閱
如需其他 CLR 型別的相關資訊,請參閱類別和結構。
您可以在編譯時期偵測某個型別是否為具有 __is_interface_class(type)
的介面。 如需詳細資訊,請參閱 類型特性的編譯程序支援。
在開發環境中,您可以藉由醒目提示 關鍵詞 (例如 interface class
) 並按 F1 來取得這些關鍵詞的 F1 說明。
Windows 執行階段
備註
(這個語言功能沒有只適用於 Windows 執行階段的備註。)
需求
編譯器選項:/ZW
通用語言執行平台
備註
(這個語言功能沒有只適用於 Common Language Runtime 的備註。)
需求
編譯器選項:/clr
範例
下列程式碼範例示範介面如何定義 clock 函式的行為。
// mcppv2_interface_class.cpp
// compile with: /clr
using namespace System;
public delegate void ClickEventHandler(int, double);
// define interface with nested interface
public interface class Interface_A {
void Function_1();
interface class Interface_Nested_A {
void Function_2();
};
};
// interface with a base interface
public interface class Interface_B : Interface_A {
property int Property_Block;
event ClickEventHandler^ OnClick;
static void Function_3() { Console::WriteLine("in Function_3"); }
};
// implement nested interface
public ref class MyClass : public Interface_A::Interface_Nested_A {
public:
virtual void Function_2() { Console::WriteLine("in Function_2"); }
};
// implement interface and base interface
public ref class MyClass2 : public Interface_B {
private:
int MyInt;
public:
// implement non-static function
virtual void Function_1() { Console::WriteLine("in Function_1"); }
// implement property
property int Property_Block {
virtual int get() { return MyInt; }
virtual void set(int value) { MyInt = value; }
}
// implement event
virtual event ClickEventHandler^ OnClick;
void FireEvents() {
OnClick(7, 3.14159);
}
};
// class that defines method called when event occurs
ref class EventReceiver {
public:
void OnMyClick(int i, double d) {
Console::WriteLine("OnClick: {0}, {1}", i, d);
}
};
int main() {
// call static function in an interface
Interface_B::Function_3();
// instantiate class that implements nested interface
MyClass ^ x = gcnew MyClass;
x->Function_2();
// instantiate class that implements interface with base interface
MyClass2 ^ y = gcnew MyClass2;
y->Function_1();
y->Property_Block = 8;
Console::WriteLine(y->Property_Block);
EventReceiver^ MyEventReceiver = gcnew EventReceiver();
// hook handler to event
y->OnClick += gcnew ClickEventHandler(MyEventReceiver, &EventReceiver::OnMyClick);
// invoke events
y->FireEvents();
// unhook handler to event
y->OnClick -= gcnew ClickEventHandler(MyEventReceiver, &EventReceiver::OnMyClick);
// call implemented function via interface handle
Interface_A^ hi = gcnew MyClass2();
hi->Function_1();
}
in Function_3
in Function_2
in Function_1
8
OnClick: 7, 3.14159
in Function_1
下列程式碼範例示範兩種方式,可使用宣告於多個介面中的相同簽章來實作函式,而類別會在哪裡使用那些介面。
// mcppv2_interface_class_2.cpp
// compile with: /clr /c
interface class I {
void Test();
void Test2();
};
interface class J : I {
void Test();
void Test2();
};
ref struct R : I, J {
// satisfies the requirement to implement Test in both interfaces
virtual void Test() {}
// implement both interface functions with explicit overrides
virtual void A() = I::Test2 {}
virtual void B() = J::Test2 {}
};