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 Array.SetValue (Object, Int64, Int64, Int64)

 

Publicado: octubre de 2016

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

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

[ComVisibleAttribute(false)]
public void SetValue(
	object value,
	long index1,
	long index2,
	long index3
)

Parámetros

value
Type: System.Object

Nuevo valor para el elemento especificado.

index1
Type: System.Int64

Entero de 64 bits que representa el índice de la primera dimensión del elemento Array que se va a establecer.

index2
Type: System.Int64

Entero de 64 bits que representa el índice de la segunda dimensión del elemento Array que se va a establecer.

index3
Type: System.Int64

Entero de 64 bits que representa el índice de la tercera dimensión del elemento Array que se va a establecer.

Exception Condition
ArgumentException

El Array actual no tiene exactamente tres dimensiones.

InvalidCastException

value no se puede convertir al tipo de elemento del Array actual.

ArgumentOutOfRangeException

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

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

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

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

System_CAPS_noteNota

Si SetValue se utiliza 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 y no se encuentra buscando una referencia nula.

En el ejemplo de código siguiente se muestra cómo establecer y obtener un valor específico en 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
Disponible desde 1.1
Volver al principio
Mostrar: