interface class (C++/CLI e C++/CX)
Dichiara un'interfaccia. Per informazioni sulle interfacce native, vedere __interface.
Tutti i runtime
Sintassi
interface_access interface class name : inherit_access base_interface {};
interface_access interface struct name : inherit_access base_interface {};
Parametri
interface_access
Accessibilità di un'interfaccia all'esterno dell'assembly. I valori possibili sono public e private. private è l'impostazione predefinita. Le interfacce annidate non possono avere un interface_access identificatore.
name
Nome dell'interfaccia.
inherit_access
Accessibilità di base_interface. L'unica accessibilità consentita per un'interfaccia di base è public (impostazione predefinita).
base_interface
(Facoltativo) Interfaccia di base per l'interfaccia name.
Osservazioni:
interface struct è pari a interface class.
Un'interfaccia può contenere dichiarazioni di funzioni, eventi e proprietà. Tutti i membri di interfaccia hanno accessibilità pubblica. Un'interfaccia può anche contenere proprietà, funzioni, eventi e membri dati statici e questi membri statici devono essere definiti nell'interfaccia.
Un'interfaccia definisce come può essere implementata una classe. Un'interfaccia non è una classe e le classi possono implementare solo interfacce. Quando una classe definisce una funzione dichiarata in un'interfaccia, la funzione viene implementata e non ne viene eseguito l'override. Pertanto, la ricerca dei nomi non include i membri dell'interfaccia.
Un class oggetto o struct che deriva da un'interfaccia deve implementare tutti i membri dell'interfaccia. Quando si implementa l'interfaccia name, è necessario implementare anche le interfacce nell'elenco base_interface .
Per altre informazioni, vedi:
Per informazioni su altri tipi CLR, vedere Classi e struct.
È possibile rilevare in fase di compilazione se un tipo è un'interfaccia con __is_interface_class(type). Per altre informazioni, vedere Supporto del compilatore per i tratti di tipo.
Nell'ambiente di sviluppo è possibile ottenere informazioni di F1 su queste parole chiave evidenziando la parola chiave (ad esempio ) interface classe premendo F1.
Windows Runtime
Osservazioni:
Non esistono note per questa funzionalità del linguaggio che si applichino solo a Windows Runtime.
Requisiti
Opzione del compilatore: /ZW
Common Language Runtime
Osservazioni:
Non esistono note per questa funzionalità del linguaggio che si applichino solo a Common Language Runtime.
Requisiti
Opzione del compilatore: /clr
Esempi
L'esempio di codice seguente illustra in che modo un'interfaccia può definire il comportamento di una funzione 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
L'esempio di codice seguente mostra due modi per implementare le funzioni con la stessa firma dichiarata in più interfacce e dove queste interfacce vengono usate da una classe.
// 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 {}
};