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)

 

Publicado: octubre de 2016

Establece un valor en el elemento situado en la posición especificada de una matriz Array unidimensional. El índice se especifica como un entero de 64 bits.

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

[ComVisibleAttribute(false)]
public void SetValue(
	object value,
	long index
)

Parámetros

value
Type: System.Object

Nuevo valor para el elemento especificado.

index
Type: System.Int64

Entero de 64 bits que representa la posición del elemento Array que se va a establecer.

Exception Condition
ArgumentException

El Array actual no tiene exactamente una dimensión.

InvalidCastException

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

ArgumentOutOfRangeException

index está fuera del intervalo de índices válidos para el Array actual.

El GetLowerBound y GetUpperBound métodos pueden determinar si el valor de index 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 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: