Type.GetInterfaceMap Method
Microsoft Silverlight will reach end of support after October 2021. Learn more.
Returns an interface mapping for the specified interface type.
Namespace: System
Assembly: mscorlib (in mscorlib.dll)
Syntax
'Declaration
<ComVisibleAttribute(True)> _
Public Overridable Function GetInterfaceMap ( _
interfaceType As Type _
) As InterfaceMapping
[ComVisibleAttribute(true)]
public virtual InterfaceMapping GetInterfaceMap(
Type interfaceType
)
Parameters
- interfaceType
Type: System.Type
The Type of the interface of which to retrieve a mapping.
Return Value
Type: System.Reflection.InterfaceMapping
An InterfaceMapping object representing the interface mapping for interfaceType.
Exceptions
| Exception | Condition |
|---|---|
| ArgumentException | The interfaceType parameter does not refer to an interface. -or- interfaceType is a generic interface, and the current type is an array type. |
| ArgumentNullException | interfaceType is nulla null reference (Nothing in Visual Basic). |
| InvalidOperationException | The current Type represents a generic type parameter; that is, IsGenericParameter is true. |
| NotSupportedException | The invoked method is not supported in the base class. Derived classes must provide an implementation. |
Remarks
The interface map denotes how an interface is mapped into the actual methods on a class that implements that interface.
If the current Type represents a constructed generic type, type parameters are replaced by the appropriate type arguments in the elements of the InterfaceMapping returned by this method.
Examples
The following example uses the GetInterfaceMap method to show the methods of the generic Dictionary<TKey, TValue> class that implement the methods of the generic IDictionary<TKey, TValue> interface.
.gif "Note") Note: |
|---|
To run this example, see Building Examples That Use a Demo Method and a TextBlock Control. |
Imports System.Reflection
Imports System.Collections.Generic
Class Example
Public Shared Sub Demo(ByVal outputBlock As System.Windows.Controls.TextBlock)
Dim obj As New Dictionary(Of Integer, String)
If obj.GetType().GetInterface("IDictionary`2", False) IsNot Nothing Then
' Get the mapping between the interface methods of the
' generic IDictionary interface and the Dictionary methods
' that implement them.
Dim idictType As Type = GetType(IDictionary(Of Integer, String))
Dim map As InterfaceMapping = _
obj.GetType().GetInterfaceMap(idictType)
Dim interfaceMethods() As MethodInfo = map.InterfaceMethods
Dim implementationMethods() As MethodInfo = map.TargetMethods
For i As Integer = 0 To interfaceMethods.Length - 1
outputBlock.Text &= interfaceMethods(i).ToString() & _
" is implemented by:" & vbLf & " " & _
implementationMethods(i).ToString() & vbLf
Next
End If
End Sub
End Class
' This example produces the following output:
'
'System.String get_Item(Int32) is implemented by:
' System.String get_Item(Int32)
'System.String set_Item(Int32, System.String) is implemented by:
' Void set_Item(Int32, System.String)
'System.Collections.Generic.ICollection`1[System.Int32] get_Keys() is implemented by:
' System.Collections.Generic.ICollection`1[System.Int32] System.Collections.Generic.IDictionary<TKey,TValue>.get_Keys()
'System.Collections.Generic.ICollection`1[System.String] get_Values() is implemented by:
' System.Collections.Generic.ICollection`1[System.String] System.Collections.Generic.IDictionary<TKey,TValue>.get_Values()
'Boolean ContainsKey(Int32) is implemented by:
' Boolean ContainsKey(Int32)
'Void Add(Int32, System.String) is implemented by:
' Void Add(Int32, System.String)
'Boolean Remove(Int32) is implemented by:
' Boolean Remove(Int32)
'Boolean TryGetValue(Int32, System.String ByRef) is implemented by:
' Boolean TryGetValue(Int32, System.String ByRef)
using System;
using System.Reflection;
using System.Collections.Generic;
class Example
{
public static void Demo(System.Windows.Controls.TextBlock outputBlock)
{
Dictionary<int, string> obj = new Dictionary<int, string>();
// Get the mapping between the interface methods of the
// generic IDictionary interface and the Dictionary methods
// that implement them.
if (obj.GetType().GetInterface("IDictionary`2", false) != null)
{
Type idictType = typeof(IDictionary<int, string>);
InterfaceMapping map = obj.GetType().GetInterfaceMap(idictType);
MethodInfo[] interfaceMethods = map.InterfaceMethods;
MethodInfo[] implementationMethods = map.TargetMethods;
for(int i=0; i<interfaceMethods.Length; i++)
{
outputBlock.Text += interfaceMethods[i].ToString() +
" is implemented by:\n " +
implementationMethods[i].ToString() + "\n";
}
}
}
}
/* This example produces the following output:
System.String get_Item(Int32) is implemented by:
System.String get_Item(Int32)
System.String set_Item(Int32, System.String) is implemented by:
Void set_Item(Int32, System.String)
System.Collections.Generic.ICollection`1[System.Int32] get_Keys() is implemented by:
System.Collections.Generic.ICollection`1[System.Int32] System.Collections.Generic.IDictionary<TKey,TValue>.get_Keys()
System.Collections.Generic.ICollection`1[System.String] get_Values() is implemented by:
System.Collections.Generic.ICollection`1[System.String] System.Collections.Generic.IDictionary<TKey,TValue>.get_Values()
Boolean ContainsKey(Int32) is implemented by:
Boolean ContainsKey(Int32)
Void Add(Int32, System.String) is implemented by:
Void Add(Int32, System.String)
Boolean Remove(Int32) is implemented by:
Boolean Remove(Int32)
Boolean TryGetValue(Int32, System.String ByRef) is implemented by:
Boolean TryGetValue(Int32, System.String ByRef)
*/
Version Information
Silverlight
Supported in: 5, 4, 3
Silverlight for Windows Phone
Supported in: Windows Phone OS 7.1, Windows Phone OS 7.0
XNA Framework
Supported in: Xbox 360, Windows Phone OS 7.0
Platforms
For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.