Este artigo foi traduzido por máquina. Para visualizar o arquivo em inglês, marque a caixa de seleção Inglês. Você também pode exibir o texto Em inglês em uma janela pop-up, movendo o ponteiro do mouse sobre o texto.
Tradução
Inglês
Esta documentação foi arquivada e não está sendo atualizada.

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

Define um valor para o elemento na posição especificada no bidimensional Array. Os índices são especificados como números inteiros de 64 bits.

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

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

Parâmetros

value
Tipo: System.Object
O novo valor para o elemento especificado.
index1
Tipo: System.Int64
Um inteiro de 64 bits que representa o índice da primeira dimensão a Array elemento a ser definido.
index2
Tipo: System.Int64
Um inteiro de 64 bits que representa o índice da segunda dimensão da Array elemento a ser definido.

ExceçãoCondição
ArgumentException

O atual Array não tem exatamente duas dimensões.

InvalidCastException

valuenão pode ser convertido para o tipo de elemento do atual Array.

ArgumentOutOfRangeException

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

O GetLowerBound e GetUpperBound métodos para determinar se qualquer um dos índices é de limites.

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

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

ObservaçãoObservação

Se SetValue é usado para atribuir null a um elemento de uma matriz de tipos de valor, todos os campos do elemento são inicializados para zero. O valor do elemento não é uma referência nula e não pode ser encontrado procurando por 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, 3.5, 3.0, 2.0, 1.1

.NET Framework Client Profile

Com suporte em: 4, 3.5 SP1

Windows 7, Windows Vista SP1 ou posterior, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core não compatível), Windows Server 2008 R2 (Server Core não compatível com SP1 ou posterior), Windows Server 2003 SP2

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 de sistema do .NET Framework.
Mostrar: