SetValue Método (Object, Int32)
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

Array.SetValue (Método) (Object, Int32)

 

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

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

public void SetValue(
	object value,
	int index
)

Parámetros

value

Nuevo valor para el elemento especificado.

index

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

Exception Condition
ArgumentException

La matriz Array actual no tiene exactamente una dimensión.

InvalidCastException

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

IndexOutOfRangeException

index se encuentra fuera del intervalo de índices válidos para la matriz Array actual.

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

*/

Universal Windows Platform
Disponible desde 10
.NET Framework
Disponible desde 1.1
Portable Class Library
Compatible con: portable .NET platforms
Silverlight
Disponible desde 2.0
Windows Phone Silverlight
Disponible desde 7.0
Volver al principio
Mostrar:
© 2016 Microsoft