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
Este tema aún no ha recibido ninguna valoración - Valorar este tema

Array.SetValue (Método) (Object, Int64[])

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 64 bits.

Espacio de nombres:  System
Ensamblado:  mscorlib (en mscorlib.dll)
[ComVisibleAttribute(false)]
public void SetValue(
	Object value,
	params long[] indices
)

Parámetros

value
Tipo: System.Object
Nuevo valor para el elemento especificado.
indices
Tipo: System.Int64[]
Matriz unidimensional de enteros de 64 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.

ArgumentOutOfRangeException

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, 4, 3.5, 3.0, 2.0, 1.1

.NET Framework Client Profile

Compatible con: 4, 3.5 SP1

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.
¿Te ha resultado útil?
(Caracteres restantes: 1500)
Gracias por sus comentarios

Adiciones de comunidad

AGREGAR
Mostrar:
© 2014 Microsoft. Reservados todos los derechos.