Type.MakeByRefType Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Vrátí Type objekt, který představuje aktuální typ, pokud je předán jako ref
parametr ( ByRef
parametr Visual Basic).
public:
abstract Type ^ MakeByRefType();
public:
virtual Type ^ MakeByRefType();
public abstract Type MakeByRefType ();
public virtual Type MakeByRefType ();
abstract member MakeByRefType : unit -> Type
abstract member MakeByRefType : unit -> Type
override this.MakeByRefType : unit -> Type
Public MustOverride Function MakeByRefType () As Type
Public Overridable Function MakeByRefType () As Type
Návraty
Objekt, Type který představuje aktuální typ, pokud je předán jako ref
parametr ( parametr v ByRef
Visual Basic).
Výjimky
Vyvolaná metoda není v základní třídě podporována.
Aktuální typ je TypedReference .
-nebo-
Aktuální typ je ByRef
typ. To znamená, že IsByRef vrátí true
.
Příklady
Následující příklad kódu vytvoří pole ( v Visual Basic) a ref
typy ukazatele pro ByRef
Test
třídu.
using namespace System;
using namespace System::Reflection;
public ref class Example
{
public:
static void Main()
{
// Create a Type object that represents a one-dimensional
// array of Example objects.
Type^ t = Example::typeid->MakeArrayType();
Console::WriteLine( L"\r\nArray of Example: {0}", t );
// Create a Type object that represents a two-dimensional
// array of Example objects.
t = Example::typeid->MakeArrayType( 2 );
Console::WriteLine( L"\r\nTwo-dimensional array of Example: {0}", t );
// Demonstrate an exception when an invalid array rank is
// specified.
try
{
t = Example::typeid->MakeArrayType( -1 );
}
catch ( Exception^ ex )
{
Console::WriteLine( L"\r\n{0}", ex );
}
// Create a Type object that represents a ByRef parameter
// of type Example.
t = Example::typeid->MakeByRefType();
Console::WriteLine( L"\r\nByRef Example: {0}", t );
// Get a Type object representing the Example class, a
// MethodInfo representing the "Test" method, a ParameterInfo
// representing the parameter of type Example, and finally
// a Type object representing the type of this ByRef parameter.
// Compare this Type object with the Type object created using
// MakeByRefType.
Type^ t2 = Example::typeid;
MethodInfo^ mi = t2->GetMethod( L"Test" );
ParameterInfo^ pi = mi->GetParameters()[ 0 ];
Type^ pt = pi->ParameterType;
Console::WriteLine( L"Are the ByRef types equal? {0}", (t == pt) );
// Create a Type object that represents a pointer to an
// Example object.
t = Example::typeid->MakePointerType();
Console::WriteLine( L"\r\nPointer to Example: {0}", t );
}
// A sample method with a ByRef parameter.
//
void Test( interior_ptr<Example^> /*e*/ )
{
}
};
int main()
{
Example::Main();
}
/* This example produces output similar to the following:
Array of Example: Example[]
Two-dimensional array of Example: Example[,]
System.IndexOutOfRangeException: Index was outside the bounds of the array.
at System.RuntimeType.MakeArrayType(Int32 rank) in c:\vbl\ndp\clr\src\BCL\System\RtType.cs:line 2999
at Example.Main()
ByRef Example: Example&
Are the ByRef types equal? True
Pointer to Example: Example*
*/
using System;
using System.Reflection;
public class Example
{
public static void Main()
{
// Create a Type object that represents a one-dimensional
// array of Example objects.
Type t = typeof(Example).MakeArrayType();
Console.WriteLine("\r\nArray of Example: {0}", t);
// Create a Type object that represents a two-dimensional
// array of Example objects.
t = typeof(Example).MakeArrayType(2);
Console.WriteLine("\r\nTwo-dimensional array of Example: {0}", t);
// Demonstrate an exception when an invalid array rank is
// specified.
try
{
t = typeof(Example).MakeArrayType(-1);
}
catch(Exception ex)
{
Console.WriteLine("\r\n{0}", ex);
}
// Create a Type object that represents a ByRef parameter
// of type Example.
t = typeof(Example).MakeByRefType();
Console.WriteLine("\r\nByRef Example: {0}", t);
// Get a Type object representing the Example class, a
// MethodInfo representing the "Test" method, a ParameterInfo
// representing the parameter of type Example, and finally
// a Type object representing the type of this ByRef parameter.
// Compare this Type object with the Type object created using
// MakeByRefType.
Type t2 = typeof(Example);
MethodInfo mi = t2.GetMethod("Test");
ParameterInfo pi = mi.GetParameters()[0];
Type pt = pi.ParameterType;
Console.WriteLine("Are the ByRef types equal? {0}", (t == pt));
// Create a Type object that represents a pointer to an
// Example object.
t = typeof(Example).MakePointerType();
Console.WriteLine("\r\nPointer to Example: {0}", t);
}
// A sample method with a ByRef parameter.
//
public void Test(ref Example e)
{
}
}
/* This example produces output similar to the following:
Array of Example: Example[]
Two-dimensional array of Example: Example[,]
System.IndexOutOfRangeException: Index was outside the bounds of the array.
at System.RuntimeType.MakeArrayType(Int32 rank) in c:\vbl\ndp\clr\src\BCL\System\RtType.cs:line 2999
at Example.Main()
ByRef Example: Example&
Are the ByRef types equal? True
Pointer to Example: Example*
*/
Imports System.Reflection
Public Class Example
Public Shared Sub Main()
' Create a Type object that represents a one-dimensional
' array of Example objects.
Dim t As Type = GetType(Example).MakeArrayType()
Console.WriteLine(vbCrLf & "Array of Example: " & t.ToString())
' Create a Type object that represents a two-dimensional
' array of Example objects.
t = GetType(Example).MakeArrayType(2)
Console.WriteLine(vbCrLf & "Two-dimensional array of Example: " & t.ToString())
' Demonstrate an exception when an invalid array rank is
' specified.
Try
t = GetType(Example).MakeArrayType(-1)
Catch ex As Exception
Console.WriteLine(vbCrLf & ex.ToString())
End Try
' Create a Type object that represents a ByRef parameter
' of type Example.
t = GetType(Example).MakeByRefType()
Console.WriteLine(vbCrLf & "ByRef Example: " & t.ToString())
' Get a Type object representing the Example class, a
' MethodInfo representing the "Test" method, a ParameterInfo
' representing the parameter of type Example, and finally
' a Type object representing the type of this ByRef parameter.
' Compare this Type object with the Type object created using
' MakeByRefType.
Dim t2 As Type = GetType(Example)
Dim mi As MethodInfo = t2.GetMethod("Test")
Dim pi As ParameterInfo = mi.GetParameters()(0)
Dim pt As Type = pi.ParameterType
Console.WriteLine("Are the ByRef types equal? " & (t Is pt))
' Create a Type object that represents a pointer to an
' Example object.
t = GetType(Example).MakePointerType()
Console.WriteLine(vbCrLf & "Pointer to Example: " & t.ToString())
End Sub
' A sample method with a ByRef parameter.
'
Public Sub Test(ByRef e As Example)
End Sub
End Class
' This example produces output similar to the following:
'
'Array of Example: Example[]
'
'Two-dimensional array of Example: Example[,]
'
'System.IndexOutOfRangeException: Index was outside the bounds of the array.
' at System.RuntimeType.MakeArrayType(Int32 rank) in c:\vbl\ndp\clr\src\BCL\System\RtType.cs:line 2999
' at Example.Main()
'
'ByRef Example: Example&
'Are the ByRef types equal? True
'
'Pointer to Example: Example*
Poznámky
Metoda MakeByRefType poskytuje způsob, jak generovat ref
typy ( v ByRef
Visual Basic) pro seznamy parametrů.
Pokud aktuální objekt představuje syntaxi jazyka MSIL (Microsoft Intermediate Language), vrátí tato metoda Type Int32 objekt představující Type Int32&
.