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

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
Tipo: System.Object
Nuevo valor para el elemento especificado.
indices
Tipo: 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.

ExcepciónCondición
ArgumentNullException

indices es null.

ArgumentException

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

InvalidCastException

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

IndexOutOfRangeException

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

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

Los métodos GetLowerBound y GetUpperBound pueden determinar si alguno de los valores de la matriz de indices 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

Biblioteca de clases portable

Compatible con: Biblioteca de clases portable

.NET para aplicaciones de la Tienda Windows

Compatible con: Windows 8

.NET para aplicaciones de Windows Phone

Compatible con: Windows Phone 8, Silverlight 8.1

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:
© 2015 Microsoft