Exportar (0) Imprimir
Expandir todo
Este artículo proviene de un motor de traducción automática. Mueva el puntero sobre las frases del artículo para ver el texto original. Más información.
Traducción
Original

Array.SetValue (Método) (Object, Int32, Int32, Int32)

Establece un valor en el elemento situado en la posición especificada de una matriz Array tridimensional. Los índices se especifican como enteros de 32 bits.

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

public void SetValue(
	Object value,
	int index1,
	int index2,
	int index3
)

Parámetros

value
Tipo: System.Object
Nuevo valor para el elemento especificado.
index1
Tipo: System.Int32
Entero de 32 bits que representa el índice de la primera dimensión del elemento Array que se va a establecer.
index2
Tipo: System.Int32
Entero de 32 bits que representa el índice de la segunda dimensión del elemento Array que se va a establecer.
index3
Tipo: System.Int32
Entero de 32 bits que representa el índice de la tercera dimensión del elemento Array que se va a establecer.

ExcepciónCondición
ArgumentException

La matriz Array actual no tiene exactamente tres dimensiones.

InvalidCastException

value no se puede convertir en el tipo de elemento de la actual matriz Array.

IndexOutOfRangeException

index1, index2 o index3 se encuentran fuera del intervalo de índices válidos para la dimensión correspondiente de la matriz Array actual.

Los métodos GetLowerBound y GetUpperBound pueden determinar si alguno de los índices queda fuera de los límites.

Para obtener más información sobre las conversiones, vea Convert.

Este método es una operación O(1).

NotaNota

Si se utiliza SetValue para asignar null a un elemento de una matriz de tipos de valor, todos los campos del elemento se inicializan en cero. El valor del elemento no es una referencia nula, por lo que no es posible encontrarlo buscando una referencia nula.

En el siguiente código de ejemplo se muestra cómo establecer y obtener un valor específico de una matriz unidimensional o multidimensional.


using System;

public class SamplesArray  {

   public static void Main()  {

      // Creates and initializes a one-dimensional array.
      String[] myArr1 = new String[5];

      // Sets the element at index 3.
      myArr1.SetValue( "three", 3 );
      Console.WriteLine( "[3]:   {0}", myArr1.GetValue( 3 ) );


      // Creates and initializes a two-dimensional array.
      String[,] myArr2 = new String[5,5];

      // Sets the element at index 1,3.
      myArr2.SetValue( "one-three", 1, 3 );
      Console.WriteLine( "[1,3]:   {0}", myArr2.GetValue( 1, 3 ) );


      // Creates and initializes a three-dimensional array.
      String[,,] myArr3 = new String[5,5,5];

      // Sets the element at index 1,2,3.
      myArr3.SetValue( "one-two-three", 1, 2, 3 );
      Console.WriteLine( "[1,2,3]:   {0}", myArr3.GetValue( 1, 2, 3 ) );


      // Creates and initializes a seven-dimensional array.
      String[,,,,,,] myArr7 = new String[5,5,5,5,5,5,5];

      // Sets the element at index 1,2,3,0,1,2,3.
      int[] myIndices = new int[7] { 1, 2, 3, 0, 1, 2, 3 };
      myArr7.SetValue( "one-two-three-zero-one-two-three", myIndices );
      Console.WriteLine( "[1,2,3,0,1,2,3]:   {0}", myArr7.GetValue( myIndices ) );

   }

}


/* 
This code produces the following output.

[3]:   three
[1,3]:   one-three
[1,2,3]:   one-two-three
[1,2,3,0,1,2,3]:   one-two-three-zero-one-two-three

*/



.NET Framework

Compatible con: 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Compatible con: 4, 3.5 SP1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (no se admite el rol Server Core), Windows Server 2008 R2 (se admite el rol Server Core con SP1 o versiones posteriores; no se admite Itanium)

.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

Adiciones de comunidad

AGREGAR
Mostrar:
© 2014 Microsoft