Exportar (0) Imprimir
Expandir Tudo
Este artigo foi traduzido por máquina. Coloque o ponteiro do mouse sobre as frases do artigo para ver o texto original. Mais informações.
Tradução
Original

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

Define um valor para o elemento na posição especificada em Arraytridimensional. Os índices são especificados como inteiros de 64 bits.

Namespace:  System
Assembly:  mscorlib (em mscorlib.dll)

[ComVisibleAttribute(false)]
public void SetValue(
	Object value,
	long index1,
	long index2,
	long index3
)

Parâmetros

value
Tipo: System.Object
O novo valor do elemento especificado.
index1
Tipo: System.Int64
Um inteiro de 64 bits que representa o índice de dimensão (do elemento de Array para definir.
index2
Tipo: System.Int64
Um inteiro de 64 bits que representa o índice do segundo dimensão do elemento de Array para definir.
index3
Tipo: System.Int64
Um inteiro de 64 bits que representa o índice de terceiro- dimensão do elemento de Array para definir.

ExceçãoCondição
ArgumentException

O Array atual não tem exatamente três dimensões.

InvalidCastException

value não pode ser convertido no tipo de elemento do Array atual.

ArgumentOutOfRangeException

index1 ou index2 ou index3 está fora do intervalo de índices válidos para a dimensão correspondente do Array atual.

Os métodos GetLowerBound e GetUpperBound podem determinar se alguns dos índices está fora dos limites.

Para obter mais informações sobre conversões, consulte Convert.

Este método é uma operação O(1).

ObservaçãoObservação

Caso SetValue seja usado para atribuir null a um elemento de uma matriz de tipos de valor, todos os campos do elemento são inicializados em zero. O valor do elemento não é uma referência nula, e não pode ser encontrada procurando uma referência nula.

O exemplo de código a seguir demonstra como definir e obter um valor específico em uma matriz unidimensional ou 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

Com suporte em: 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0, 1.1

.NET Framework Client Profile

Com suporte em: 4, 3.5 SP1

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 (Função Server Core sem suporte), Windows Server 2008 R2 (Função Server Core com suporte com o SP1 ou posterior, Itanium sem suporte)

O .NET Framework não oferece suporte a todas as versões de cada plataforma. Para obter uma lista das versões com suporte, consulte Requisitos do sistema do .NET Framework.

Contribuições da comunidade

ADICIONAR
Mostrar:
© 2014 Microsoft