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, Int32[])

 

Publicado: octubre de 2016

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

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

public void SetValue(
	object value,
	params int[] indices
)

Parámetros

value
Type: System.Object

Nuevo valor para el elemento especificado.

indices
Type: System.Int32[]

Matriz unidimensional de enteros de 32 bits que representan los índices que especifican la posición del elemento que se va a establecer.

Exception Condition
ArgumentNullException

El valor de indices es null.

ArgumentException

El número de dimensiones de la Array actual no es igual al número de elementos de indices.

InvalidCastException

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

IndexOutOfRangeException

Cualquier elemento de indices está fuera del intervalo de índices válidos para la dimensión correspondiente de la Array actual.

El número de elementos de indices debe ser igual al número de dimensiones en el Array. Todos los elementos de la indices matriz debe especificar la posición del elemento deseado en conjunto multidimensional Array.

El GetLowerBound y GetUpperBound métodos pueden determinar si alguno de los valores de la indices matriz está fuera de 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 usa 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 puede encontrar 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

*/

Plataforma universal de Windows
Disponible desde 8
.NET Framework
Disponible desde 1.1
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: