Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

Método Type.MakeArrayType (Int32)

 

Devuelve un objeto Type que representa una matriz del tipo actual, con el número de dimensiones especificado.

Espacio de nombres:   System
Ensamblado:  mscorlib (en mscorlib.dll)

public virtual Type MakeArrayType(
	int rank
)

Parámetros

rank
Type: System.Int32

Número de dimensiones de la matriz. Este número debe ser menor o igual que 32.

Valor devuelto

Type: System.Type

Objeto que representa una matriz del tipo actual, con el número de dimensiones especificado.

Exception Condition
IndexOutOfRangeException

rank no es válido. Por ejemplo, 0 o negativo.

NotSupportedException

No se admite el método invocado en la clase base.

TypeLoadException

El tipo actual es TypedReference.

-o-

El tipo actual es un tipo ByRef. Es decir, Type.IsByRef devuelve true.

-o-

rank es mayor que 32.

El MakeArrayType método proporciona un medio para generar tipos de matriz cuyos tipos de elemento se calculan en tiempo de ejecución.

System_CAPS_noteNota

Common language runtime distingue entre vectores (es decir, las matrices unidimensionales que siempre son de base cero) y matrices multidimensionales. Un vector, que siempre tiene sólo una dimensión, no es igual a una matriz multidimensional que se produce a tener solamente una dimensión. No se puede utilizar esta sobrecarga del método para crear un tipo de vector; Si rank es 1, esta sobrecarga del método devuelve un tipo de matriz multidimensional que posee una dimensión. Use la MakeArrayType() sobrecarga del método para crear tipos de vector.

En el ejemplo de código siguiente se crea la matriz, ref (ByRef en Visual Basic) y los tipos de puntero para la Test clase.

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*

 */

Plataforma universal de Windows
Disponible desde 8
.NET Framework
Disponible desde 2.0
Biblioteca de clases portable
Se admite en: plataformas portátiles de .NET
Silverlight
Disponible desde 2.0
Windows Phone Silverlight
Disponible desde 7.0
Windows Phone
Disponible desde 8.1
Volver al principio
Mostrar: