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

Classe Array

 
System_CAPS_noteObservação

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

Fornece métodos para criar, manipular, pesquisar e classificar matrizes, servindo assim como a classe base para todas as matrizes no Common Language Runtime.

Para procurar o código-fonte do .NET Framework para este tipo, consulte o Reference Source.

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


[SerializableAttribute]
[ComVisibleAttribute(true)]
public abstract class Array : ICloneable, IList, ICollection, 
	IEnumerable, IStructuralComparable, IStructuralEquatable

NomeDescrição
System_CAPS_pubpropertyIsFixedSize

Obtém um valor que indica se o Array tem um tamanho fixo.

System_CAPS_pubpropertyIsReadOnly

Obtém um valor que indica se o Array é somente leitura.

System_CAPS_pubpropertyIsSynchronized

Obtém um valor que indica se o acesso à Array é sincronizado (thread-safe).

System_CAPS_pubpropertyLength

Obtém o número total de elementos em todas as dimensões do Array.

System_CAPS_pubpropertyLongLength

Obtém um inteiro de 64 bits que representa o número total de elementos em todas as dimensões do Array.

System_CAPS_pubpropertyRank

Obtém a classificação (número de dimensões) do Array. Por exemplo, uma matriz unidimensional retorna 1, uma matriz bidimensional retorna 2 e assim por diante.

System_CAPS_pubpropertySyncRoot

Obtém um objeto que pode ser usado para sincronizar o acesso ao Array.

NomeDescrição
System_CAPS_pubmethodSystem_CAPS_staticAsReadOnly<T>(T[])

Retorna um wrapper somente leitura para a matriz especificada.

System_CAPS_pubmethodSystem_CAPS_staticBinarySearch(Array, Int32, Int32, Object)

Pesquisa um intervalo de elementos em uma matriz unidimensional classificada para um valor, usando a interface IComparable implementada por cada elemento da matriz e pelo valor especificado.

System_CAPS_pubmethodSystem_CAPS_staticBinarySearch(Array, Int32, Int32, Object, IComparer)

Pesquisa uma variedade de elementos em uma matriz classificada unidimensional para um valor usando a interface IComparer especificada.

System_CAPS_pubmethodSystem_CAPS_staticBinarySearch(Array, Object)

Pesquisa uma matriz unidimensional inteira classificada por um elemento específico, usando a IComparable interface implementada por cada elemento da matriz e o objeto especificado.

System_CAPS_pubmethodSystem_CAPS_staticBinarySearch(Array, Object, IComparer)

Pesquisa um valor usando a interface IComparer especificada em uma matriz classificada unidimensional inteira.

System_CAPS_pubmethodSystem_CAPS_staticBinarySearch<T>(T[], T)

Pesquisa uma matriz unidimensional inteira classificada por um elemento específico, usando a interface IComparable<T> genérica implementada por cada elemento da Array e o objeto especificado.

System_CAPS_pubmethodSystem_CAPS_staticBinarySearch<T>(T[], T, IComparer<T>)

Pesquisa uma matriz classificada unidimensional completa para um valor usando a interface genérica de IComparer<T> especificada.

System_CAPS_pubmethodSystem_CAPS_staticBinarySearch<T>(T[], Int32, Int32, T)

Pesquisa um intervalo de elementos em uma matriz unidimensional classificada em busca de um valor, usando a interface genérica IComparable<T> implementada por cada elemento do Array e pelo valor especificado.

System_CAPS_pubmethodSystem_CAPS_staticBinarySearch<T>(T[], Int32, Int32, T, IComparer<T>)

Pesquisa uma variedade de elementos em uma matriz classificada unidimensional para um valor usando a interface genérica de IComparer<T> especificada.

System_CAPS_pubmethodSystem_CAPS_staticClear(Array, Int32, Int32)

Define um intervalo de elementos em uma matriz como o valor padrão de cada tipo de elemento.

System_CAPS_pubmethodClone()

Cria uma cópia superficial do Array.

System_CAPS_pubmethodSystem_CAPS_staticConstrainedCopy(Array, Int32, Array, Int32, Int32)

Copia um intervalo de elementos de um Array a partir do índice de origem especificado e cola-os em outro Array a partir do índice de destino especificado. Garante que todas as alterações serão desfeitas se a cópia não foi bem-sucedida por completo.

System_CAPS_pubmethodSystem_CAPS_staticConvertAll<TInput, TOutput>(TInput[], Converter<TInput, TOutput>)

Converte uma matriz de um tipo para uma matriz de outro tipo.

System_CAPS_pubmethodSystem_CAPS_staticCopy(Array, Array, Int32)

Copia um intervalo de elementos de uma Array iniciando no primeiro elemento e cola-o em outro Array, iniciando no primeiro elemento. O comprimento é especificado como um inteiro de 32 bits.

System_CAPS_pubmethodSystem_CAPS_staticCopy(Array, Array, Int64)

Copia um intervalo de elementos de uma Array iniciando no primeiro elemento e cola-o em outro Array, iniciando no primeiro elemento. O tamanho é especificado como um inteiro de 64 bits.

System_CAPS_pubmethodSystem_CAPS_staticCopy(Array, Int32, Array, Int32, Int32)

Copia um intervalo de elementos de um Array a partir do índice de origem especificado e cola-os em outro Array a partir do índice de destino especificado. A altura e os índices são especificados como inteiros de 32 bits.

System_CAPS_pubmethodSystem_CAPS_staticCopy(Array, Int64, Array, Int64, Int64)

Copia um intervalo de elementos de um Array a partir do índice de origem especificado e cola-os em outro Array a partir do índice de destino especificado. O tamanho e os índices são especificados como inteiros de 64 bits.

System_CAPS_pubmethodCopyTo(Array, Int32)

Copia todos os elementos da matriz unidimensional atual para a matriz unidimensional especificada começando no índice de matriz de destino especificado. O índice é especificado como um inteiro de 32 bits.

System_CAPS_pubmethodCopyTo(Array, Int64)

Copia todos os elementos da matriz unidimensional atual para a matriz unidimensional especificada começando no índice de matriz de destino especificado. O índice é especificado como um inteiro de 64 bits.

System_CAPS_pubmethodSystem_CAPS_staticCreateInstance(Type, Int32)

Cria um Array unidimensional do Type especificado e tamanho, com a indexação com base em zero.

System_CAPS_pubmethodSystem_CAPS_staticCreateInstance(Type, Int32, Int32)

Cria um Array bidimensional do Type e comprimentos de dimensão especificados, com a indexação com base em zero.

System_CAPS_pubmethodSystem_CAPS_staticCreateInstance(Type, Int32, Int32, Int32)

Cria um Array tridimensional do Type e comprimentos de dimensão especificados, com a indexação com base em zero.

System_CAPS_pubmethodSystem_CAPS_staticCreateInstance(Type, Int32[])

Cria um Array multidimensional do Type e comprimentos de dimensão especificados, com a indexação com base zero. Os tamanhos da dimensão são especificados em uma matriz de inteiros de 32 bits.

System_CAPS_pubmethodSystem_CAPS_staticCreateInstance(Type, Int32[], Int32[])

Cria um Array multidimensional com o Type especificado e com os tamanhos da dimensão, com os limites inferiores especificados.

System_CAPS_pubmethodSystem_CAPS_staticCreateInstance(Type, Int64[])

Cria um Array multidimensional do Type e comprimentos de dimensão especificados, com a indexação com base zero. Os tamanhos da dimensão são especificados em uma matriz de inteiros de 64 bits.

System_CAPS_pubmethodSystem_CAPS_staticEmpty<T>()

Retorna uma matriz vazia.

System_CAPS_pubmethodEquals(Object)

Determina se o objeto especificado é igual ao objeto atual.(Herdado de Object.)

System_CAPS_pubmethodSystem_CAPS_staticExists<T>(T[], Predicate<T>)

Determina se a matriz especificada contém elementos que correspondem às condições definidas pelo predicado especificado.

System_CAPS_protmethodFinalize()

Permite que um objeto tente liberar recursos e executar outras operações de limpeza antes de ser recuperado pela coleta de lixo.(Herdado de Object.)

System_CAPS_pubmethodSystem_CAPS_staticFind<T>(T[], Predicate<T>)

Pesquisa um elemento que corresponde às condições definidas pelo predicado especificado e retorna a primeira ocorrência em toda a Array.

System_CAPS_pubmethodSystem_CAPS_staticFindAll<T>(T[], Predicate<T>)

Recupera todos os elementos que correspondem às condições definidas pelo predicado especificado.

System_CAPS_pubmethodSystem_CAPS_staticFindIndex<T>(T[], Int32, Int32, Predicate<T>)

Pesquisa um elemento que coincida com as condições definidas pelo predicado especificado e retorna o índice baseado em zero da primeira ocorrência dentro do intervalo de elementos na Array que começa no índice especificado e contém o número de elementos especificado.

System_CAPS_pubmethodSystem_CAPS_staticFindIndex<T>(T[], Int32, Predicate<T>)

Pesquisa um elemento que corresponda às condições definidas pelo predicado especificado e retorna o índice baseado em zero da primeira ocorrência dentro do intervalo de elementos no Array que se estende do índice especificado ao último elemento.

System_CAPS_pubmethodSystem_CAPS_staticFindIndex<T>(T[], Predicate<T>)

Pesquisa um elemento que corresponde às condições definidas pelo predicado especificado e retorna o índice baseado em zero da primeira ocorrência em toda a Array.

System_CAPS_pubmethodSystem_CAPS_staticFindLast<T>(T[], Predicate<T>)

Pesquisa um elemento que corresponda às condições definidas pelo predicado especificado e retorna a primeira ocorrência em toda a Array.

System_CAPS_pubmethodSystem_CAPS_staticFindLastIndex<T>(T[], Int32, Int32, Predicate<T>)

Pesquisa por um elemento que corresponda às condições definidas pelo predicado especificado e retorna o índice baseado em zero da última ocorrência no intervalo de elementos no Array que contém o número de elementos especificado e termina no índice especificado.

System_CAPS_pubmethodSystem_CAPS_staticFindLastIndex<T>(T[], Int32, Predicate<T>)

Pesquisa um elemento que corresponde às condições definidas pelo predicado especificado e retorna o índice baseado em zero da última ocorrência dentro do intervalo de elementos no Array que se estende do primeiro elemento ao índice especificado.

System_CAPS_pubmethodSystem_CAPS_staticFindLastIndex<T>(T[], Predicate<T>)

Pesquisa um elemento que corresponde às condições definidas pelo predicado especificado e retorna o índice baseado em zero da última ocorrência em toda a Array.

System_CAPS_pubmethodSystem_CAPS_staticForEach<T>(T[], Action<T>)

Executa a ação especificada em cada elemento da matriz especificada.

System_CAPS_pubmethodGetEnumerator()

Retorna um IEnumerator para o Array.

System_CAPS_pubmethodGetHashCode()

Serve como a função de hash padrão.(Herdado de Object.)

System_CAPS_pubmethodGetLength(Int32)

Obtém um inteiro de 32 bits que representa o número de elementos na dimensão especificada do Array.

System_CAPS_pubmethodGetLongLength(Int32)

Obtém um inteiro de 64 bits que representa o número de elementos na dimensão especificada do Array.

System_CAPS_pubmethodGetLowerBound(Int32)

Obtém o índice do primeiro elemento da dimensão especificada na matriz.

System_CAPS_pubmethodGetType()

Obtém o Type da instância atual.(Herdado de Object.)

System_CAPS_pubmethodGetUpperBound(Int32)

Obtém o índice do último elemento da dimensão especificada na matriz.

System_CAPS_pubmethodGetValue(Int32)

Obtém o valor na posição especificada no Array unidimensional. O índice é especificado como um inteiro de 32 bits.

System_CAPS_pubmethodGetValue(Int32, Int32)

Obtém o valor na posição especificada no Array bidimensional. Os índices são especificados como inteiro de 32 bits.

System_CAPS_pubmethodGetValue(Int32, Int32, Int32)

Obtém o valor na posição especificada no Array tridimensional. Os índices são especificados como inteiro de 32 bits.

System_CAPS_pubmethodGetValue(Int32[])

Obtém o valor na posição especificada no Array multidimensional. Os índices são especificados como uma matriz de inteiros de 32 bits.

System_CAPS_pubmethodGetValue(Int64)

Obtém o valor na posição especificada no Array unidimensional. O índice é especificado como um inteiro de 64 bits.

System_CAPS_pubmethodGetValue(Int64, Int64)

Obtém o valor na posição especificada no Array bidimensional. Os índices são especificados como inteiros de 64 bits.

System_CAPS_pubmethodGetValue(Int64, Int64, Int64)

Obtém o valor na posição especificada no Array tridimensional. Os índices são especificados como inteiros de 64 bits.

System_CAPS_pubmethodGetValue(Int64[])

Obtém o valor na posição especificada no Array multidimensional. Os índices são especificados como uma matriz de inteiros de 64 bits.

System_CAPS_pubmethodSystem_CAPS_staticIndexOf(Array, Object)

Pesquisa o objeto especificado e retorna o índice da primeira ocorrência em uma matriz unidimensional.

System_CAPS_pubmethodSystem_CAPS_staticIndexOf(Array, Object, Int32)

Pesquisa o objeto especificado em um intervalo de elementos de uma matriz unidimensional e retorna o índice da primeira ocorrência. O intervalo se estende de um índice especificado ao final da matriz.

System_CAPS_pubmethodSystem_CAPS_staticIndexOf(Array, Object, Int32, Int32)

Pesquisa pelo objeto especificado em um intervalo de elementos de uma matriz unidimensional e retorna o índice da primeira ocorrência. O intervalo estende-se de um índice especificado a um número especificado de elementos.

System_CAPS_pubmethodSystem_CAPS_staticIndexOf<T>(T[], T)

Pesquisa o objeto especificado e retorna o índice da primeira ocorrência em uma matriz unidimensional.

System_CAPS_pubmethodSystem_CAPS_staticIndexOf<T>(T[], T, Int32)

Pesquisa o objeto especificado em um intervalo de elementos de uma matriz unidimensional e retorna o índice da primeira ocorrência. O intervalo se estende de um índice especificado ao final da matriz.

System_CAPS_pubmethodSystem_CAPS_staticIndexOf<T>(T[], T, Int32, Int32)

Pesquisa o objeto especificado em um intervalo de elementos de uma matriz unidimensional e retorna o índice da primeira ocorrência. O intervalo estende-se de um índice especificado a um número especificado de elementos.

System_CAPS_pubmethodInitialize()

Inicializa todos os elementos do tipo de valor Array chamando o construtor padrão do tipo de valor.

System_CAPS_pubmethodSystem_CAPS_staticLastIndexOf(Array, Object)

Pesquisa o objeto especificado e retorna o índice da última ocorrência dentro de toda a Array unidimensional.

System_CAPS_pubmethodSystem_CAPS_staticLastIndexOf(Array, Object, Int32)

Pesquisa o objeto especificado e retorna o índice da última ocorrência dentro do intervalo de elementos no unidimensional Array que se estende do primeiro elemento para o índice especificado.

System_CAPS_pubmethodSystem_CAPS_staticLastIndexOf(Array, Object, Int32, Int32)

Pesquisa o objeto especificado e retorna o índice da última ocorrência no intervalo de elementos no Array unidimensional que contém o número de elementos especificado e termina no índice especificado.

System_CAPS_pubmethodSystem_CAPS_staticLastIndexOf<T>(T[], T)

Pesquisa o objeto especificado e retorna o índice da última ocorrência dentro de toda a Array.

System_CAPS_pubmethodSystem_CAPS_staticLastIndexOf<T>(T[], T, Int32)

Pesquisa o objeto especificado e retorna o índice da última ocorrência dentro do intervalo de elementos de Array que se estende do primeiro elemento para o índice especificado.

System_CAPS_pubmethodSystem_CAPS_staticLastIndexOf<T>(T[], T, Int32, Int32)

Pesquisa o objeto especificado e retorna o índice da última ocorrência dentro do intervalo de elementos de Array que contém o número especificado de elementos e termina no índice especificado.

System_CAPS_protmethodMemberwiseClone()

Cria uma cópia superficial do Object atual.(Herdado de Object.)

System_CAPS_pubmethodSystem_CAPS_staticResize<T>(T[], Int32)

Altera o número de elementos de uma matriz unidimensional para o novo tamanho especificado.

System_CAPS_pubmethodSystem_CAPS_staticReverse(Array)

Inverte a sequência dos elementos em todo o Array unidimensional.

System_CAPS_pubmethodSystem_CAPS_staticReverse(Array, Int32, Int32)

Inverte a sequência dos elementos em toda gama de elementos no Array unidimensional.

System_CAPS_pubmethodSetValue(Object, Int32)

Define um valor como o elemento na posição especificada no Array unidimensional. O índice é especificado como um inteiro de 32 bits.

System_CAPS_pubmethodSetValue(Object, Int32, Int32)

Define um valor como o elemento na posição especificada no Array bidimensional. Os índices são especificados como inteiro de 32 bits.

System_CAPS_pubmethodSetValue(Object, Int32, Int32, Int32)

Define um valor para o elemento na posição especificada no tridimensional Array. Os índices são especificados como inteiro de 32 bits.

System_CAPS_pubmethodSetValue(Object, Int32[])

Define um valor para o elemento na posição especificada na Array multidimensional. Os índices são especificados como uma matriz de inteiros de 32 bits.

System_CAPS_pubmethodSetValue(Object, Int64)

Define um valor como o elemento na posição especificada no Array unidimensional. O índice é especificado como um inteiro de 64 bits.

System_CAPS_pubmethodSetValue(Object, Int64, Int64)

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

System_CAPS_pubmethodSetValue(Object, Int64, Int64, Int64)

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

System_CAPS_pubmethodSetValue(Object, Int64[])

Define um valor para o elemento na posição especificada na Array multidimensional. Os índices são especificados como uma matriz de inteiros de 64 bits.

System_CAPS_pubmethodSystem_CAPS_staticSort(Array)

Classifica os elementos em todo um Array unidimensional usando a implementação IComparable de cada elemento do Array.

System_CAPS_pubmethodSystem_CAPS_staticSort(Array, Array)

Classifica um par de objetos Array unidimensionais (um contém as chaves e o outro contém os itens correspondentes) com base nas chaves no primeiro Array usando a implementação IComparable de cada chave.

System_CAPS_pubmethodSystem_CAPS_staticSort(Array, Array, IComparer)

Classifica um par objetos Array unidimensionais (um contém as chaves e o outro contém os itens correspondentes) com base nas chaves no primeiro Array usando o IComparer especificado.

System_CAPS_pubmethodSystem_CAPS_staticSort(Array, Array, Int32, Int32)

Classifica um intervalo de elementos em um par de objetos Array unidirecionais (um contém as chaves e o outro contém os itens correspondentes) com base nas chaves do primeiro Array usando a implementação IComparable de cada chave.

System_CAPS_pubmethodSystem_CAPS_staticSort(Array, Array, Int32, Int32, IComparer)

Classifica uma gama de elementos em um par de objetos Array unidimensionais (um contém as chaves e o outro contém os itens correspondentes) com base nas chaves no primeiro Array usando o IComparer especificado.

System_CAPS_pubmethodSystem_CAPS_staticSort(Array, IComparer)

Classifica os elementos em um Array unidimensional usando o IComparer especificado.

System_CAPS_pubmethodSystem_CAPS_staticSort(Array, Int32, Int32)

Classifica os elementos em um intervalo de elementos em um Array unidimensional usando a implementação IComparable de cada elemento do Array.

System_CAPS_pubmethodSystem_CAPS_staticSort(Array, Int32, Int32, IComparer)

Classifica os elementos em um intervalo de elementos em um Array unidimensional usando o IComparer especificado.

System_CAPS_pubmethodSystem_CAPS_staticSort<T>(T[])

Classifica os elementos em todo um Array usando a implementação de interface genérica do IComparable<T> de cada elemento do Array.

System_CAPS_pubmethodSystem_CAPS_staticSort<T>(T[], Comparison<T>)

Classifica os elementos em um Array usando o Comparison<T> especificado.

System_CAPS_pubmethodSystem_CAPS_staticSort<T>(T[], IComparer<T>)

Classifica os elementos em um Array usando a interface genérica IComparer<T> especificada.

System_CAPS_pubmethodSystem_CAPS_staticSort<T>(T[], Int32, Int32)

Classifica os elementos em um intervalo de elementos em um Array usando a implementação de interface genérica do IComparable<T> de cada elemento do Array.

System_CAPS_pubmethodSystem_CAPS_staticSort<T>(T[], Int32, Int32, IComparer<T>)

Classifica os elementos em um intervalo de elementos em um Array usando a interface genérica IComparer<T> especificada.

System_CAPS_pubmethodSystem_CAPS_staticSort<TKey, TValue>(TKey[], TValue[])

Classifica um par de objetos Array (um contém as chaves e outro contém os itens correspondentes) com base nas chaves no primeiro Array usando a implementação da interface genérica IComparable<T> de cada chave.

System_CAPS_pubmethodSystem_CAPS_staticSort<TKey, TValue>(TKey[], TValue[], IComparer<TKey>)

Classifica um par de objetos Array (um contém as chaves e o outro contém os itens correspondentes) com base nas chaves no primeiro Array usando a interface genérica IComparer<T> especificada.

System_CAPS_pubmethodSystem_CAPS_staticSort<TKey, TValue>(TKey[], TValue[], Int32, Int32)

Classifica uma gama de elementos em um par de objetos Array (um contém as chaves e outro contém os itens correspondentes) com base nas chaves no primeiro Array usando a implementação da interface genérica IComparable<T> de cada chave.

System_CAPS_pubmethodSystem_CAPS_staticSort<TKey, TValue>(TKey[], TValue[], Int32, Int32, IComparer<TKey>)

Classifica uma gama de elementos em um par de objetos Array (um contém as chaves e o outro contém os itens correspondentes) com base nas chaves no primeiro Array usando a interface genérica IComparer<T> especificada.

System_CAPS_pubmethodToString()

Retorna uma cadeia de caracteres que representa o objeto atual.(Herdado de Object.)

System_CAPS_pubmethodSystem_CAPS_staticTrueForAll<T>(T[], Predicate<T>)

Determina se cada elemento na matriz corresponde às condições definidas pelo predicado especificado.

NomeDescrição
System_CAPS_pubinterfaceSystem_CAPS_privmethodIList.Add(Object)

A chamada desse método sempre gera uma exceção NotSupportedException.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIList.Clear()

Remove todos os itens do IList.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIList.Contains(Object)

Determina se um elemento está no IList.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIList.IndexOf(Object)

Determina o índice de um item específico no IList.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIList.Insert(Int32, Object)

Insere um item no IList no índice especificado.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIList.Remove(Object)

Remove a primeira ocorrência de um objeto específico do IList.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIList.RemoveAt(Int32)

Remove o item IList no índice especificado.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIStructuralComparable.CompareTo(Object, IComparer)

Determina se o objeto da coleção atual precede, ocorre na mesma posição ou segue a outro objeto na ordem de classificação.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIStructuralEquatable.Equals(Object, IEqualityComparer)

Determina se um objeto é igual à instância atual.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIStructuralEquatable.GetHashCode(IEqualityComparer)

Retorna um código hash para a instância atual.

System_CAPS_pubinterfaceSystem_CAPS_privpropertyICollection.Count

Obtém o número de elementos contidos no Array.

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIList.Item[Int32]

Obtém ou define o elemento no índice especificado.

NomeDescrição
System_CAPS_pubmethodAsParallel()

Sobrecarregado. Habilita a paralelização de uma consulta.(Definido pelo ParallelEnumerable.)

System_CAPS_pubmethodAsQueryable()

Sobrecarregado. Converte um IEnumerable em um IQueryable.(Definido pelo Queryable.)

System_CAPS_pubmethodCast<TResult>()

Converte os elementos de um IEnumerable para o tipo especificado.(Definido pelo Enumerable.)

System_CAPS_pubmethodOfType<TResult>()

Filtra os elementos de um IEnumerable com base em um tipo especificado.(Definido pelo Enumerable.)

System_CAPS_noteObservação

Para exibir o código-fonte do .NET Framework para este tipo, consulte o Reference Source. Percorra o código-fonte online, baixe a referência para exibição offline e percorrer as fontes (incluindo atualizações e patches) durante a depuração; consulte instructions.

O Array a classe não é parte do System.Collections namespaces. No entanto, ela ainda será considerada uma coleção porque ele se baseia o IList interface.

O Array classe é a classe base para implementações de linguagem que oferece suporte a matrizes. No entanto, somente o sistema e os compiladores podem derivar explicitamente o Array classe. Os usuários devem empregar as construções de matriz fornecidas pela linguagem.

Um elemento é um valor em um Array. O comprimento de um Array é o número total de elementos que ele pode conter. O limite inferior de um Array é o índice do seu primeiro elemento. Um Array pode ter qualquer limite inferior, mas ele tem um limite inferior de zero por padrão. Um limite inferior diferente pode ser definido ao criar uma instância do Array classe usando CreateInstance. Um multidimensionais Array pode ter limites diferentes para cada dimensão. Uma matriz pode ter um máximo de 32 dimensões.

Ao contrário das classes no System.Collections namespaces, Array tem uma capacidade fixa. Para aumentar a capacidade, você deve criar um novo Array de objeto com a capacidade necessária, copiar os elementos do antigo Array do objeto para o novo e excluir o antigo Array.

Por padrão, o tamanho máximo de um Array é de 2 gigabytes (GB). Em um ambiente de 64 bits, você pode evitar a restrição de tamanho, definindo o enabled atributo o gcAllowVeryLargeObjects elemento de configuração para true no ambiente de tempo de execução. No entanto, a matriz ainda será limitada a um total de elementos de 4 bilhões e um índice máximo de 0X7FEFFFFF em uma determinada dimensão (0X7FFFFFC7 para matrizes de bytes e matrizes de estruturas de byte único).

Começando com o .NET Framework 2.0, o Array classe implementa o System.Collections.Generic.IList<T>, System.Collections.Generic.ICollection<T>, e System.Collections.Generic.IEnumerable<T> interfaces genéricas. As implementações são fornecidas para matrizes em tempo de execução, e como resultado, as interfaces genéricas não aparecem na sintaxe de declaração para o Array classe. Além disso, não há nenhum tópicos de referência para os membros de interface que são acessíveis somente por conversão de uma matriz para o tipo de interface genérica (implementações explícitas da interface). O mais importante estar atento ao converter uma matriz para uma dessas interfaces é que os membros que adicionam, inserir ou remover elementos throw NotSupportedException.

Typeobjetos fornecem informações sobre declarações de tipo de matriz. Arrayobjetos com o mesmo tipo de matriz compartilham o mesmo Type objeto.

Type.IsArraye Type.GetElementType podem não retornar os resultados esperados com Array porque se uma matriz é convertida para o tipo Array, o resultado é um objeto, não uma matriz. Ou seja, typeof(System.Array).IsArray retorna false, e typeof(System.Array).GetElementType retorna null.

O Array.Copy método copia não apenas entre matrizes do mesmo tipo, mas também entre matrizes de padrão de tipos diferentes de elementos; ele trata automaticamente de conversão de tipos.

Alguns métodos, como CreateInstance, Copy, CopyTo, GetValue, e SetValue, fornecem sobrecargas que aceitam números inteiros de 64 bits como parâmetros para acomodar as matrizes de capacidade grande. LongLengthe GetLongLength retornam números inteiros de 64 bits que indica o comprimento da matriz.

O Array não é garantida a ser classificada. Você deve classificar o Array antes de executar operações (como BinarySearch) que exigem o Array a ser classificada.

Usando um Array objeto dos ponteiros em código nativo não é compatível e gerará um NotSupportedException para vários métodos.

O seguinte exemplo de código mostra como Array.Copy copia os elementos entre uma matriz de tipo inteiro e uma matriz do tipo Object.

using System;
public class SamplesArray  {

    public static void Main()  {

       // Creates and initializes a new integer array and a new Object array.
       int[] myIntArray = new int[5] { 1, 2, 3, 4, 5 };
       Object[] myObjArray = new Object[5] { 26, 27, 28, 29, 30 };

       // Prints the initial values of both arrays.
       Console.WriteLine( "Initially," );
       Console.Write( "integer array:" );
       PrintValues( myIntArray );
       Console.Write( "Object array: " );
       PrintValues( myObjArray );

       // Copies the first two elements from the integer array to the Object array.
       System.Array.Copy( myIntArray, myObjArray, 2 );

       // Prints the values of the modified arrays.
       Console.WriteLine( "\nAfter copying the first two elements of the integer array to the Object array," );
       Console.Write( "integer array:" );
       PrintValues( myIntArray );
       Console.Write( "Object array: " );
       PrintValues( myObjArray );

       // Copies the last two elements from the Object array to the integer array.
       System.Array.Copy( myObjArray, myObjArray.GetUpperBound(0) - 1, myIntArray, myIntArray.GetUpperBound(0) - 1, 2 );

       // Prints the values of the modified arrays.
       Console.WriteLine( "\nAfter copying the last two elements of the Object array to the integer array," );
       Console.Write( "integer array:" );
       PrintValues( myIntArray );
       Console.Write( "Object array: " );
       PrintValues( myObjArray );
    }


    public static void PrintValues( Object[] myArr )  {
       foreach ( Object i in myArr )  {
          Console.Write( "\t{0}", i );
       }
       Console.WriteLine();
    }

    public static void PrintValues( int[] myArr )  {
       foreach ( int i in myArr )  {
          Console.Write( "\t{0}", i );
       }
       Console.WriteLine();
    }
 }
 /* 
 This code produces the following output.

 Initially,
 integer array:  1       2       3       4       5
 Object array:   26      27      28      29      30

 After copying the first two elements of the integer array to the Object array,
 integer array:  1       2       3       4       5
 Object array:   1       2       28      29      30

 After copying the last two elements of the Object array to the integer array,
 integer array:  1       2       3       29      30
 Object array:   1       2       28      29      30
 */

O exemplo de código a seguir cria e inicializa um Array e exibe suas propriedades e seus elementos.

using System;
public class SamplesArray2{

    public static void Main()  {

       // Creates and initializes a new three-dimensional Array of type Int32.
       Array myArr = Array.CreateInstance( typeof(Int32), 2, 3, 4 );
       for ( int i = myArr.GetLowerBound(0); i <= myArr.GetUpperBound(0); i++ )
          for ( int j = myArr.GetLowerBound(1); j <= myArr.GetUpperBound(1); j++ )
             for ( int k = myArr.GetLowerBound(2); k <= myArr.GetUpperBound(2); k++ )  {
                myArr.SetValue( (i*100)+(j*10)+k, i, j, k );
             }

       // Displays the properties of the Array.
       Console.WriteLine( "The Array has {0} dimension(s) and a total of {1} elements.", myArr.Rank, myArr.Length );
       Console.WriteLine( "\tLength\tLower\tUpper" );
       for ( int i = 0; i < myArr.Rank; i++ )  {
          Console.Write( "{0}:\t{1}", i, myArr.GetLength(i) );
          Console.WriteLine( "\t{0}\t{1}", myArr.GetLowerBound(i), myArr.GetUpperBound(i) );
       }

       // Displays the contents of the Array.
       Console.WriteLine( "The Array contains the following values:" );
       PrintValues( myArr );
    }


    public static void PrintValues( Array myArr )  {
       System.Collections.IEnumerator myEnumerator = myArr.GetEnumerator();
       int i = 0;
       int cols = myArr.GetLength( myArr.Rank - 1 );
       while ( myEnumerator.MoveNext() )  {
          if ( i < cols )  {
             i++;
          } else  {
             Console.WriteLine();
             i = 1;
          }
          Console.Write( "\t{0}", myEnumerator.Current );
       }
       Console.WriteLine();
    }
 }
 /* 
 This code produces the following output.

 The Array has 3 dimension(s) and a total of 24 elements.
     Length    Lower    Upper
 0:    2    0    1
 1:    3    0    2
 2:    4    0    3
 The Array contains the following values:
     0    1    2    3
     10    11    12    13
     20    21    22    23
     100    101    102    103
     110    111    112    113
     120    121    122    123
 */

Plataforma Universal do Windows
Disponível desde 8
.NET Framework
Disponível desde 1.1
Biblioteca de Classes Portátil
Com suporte no: plataformas portáteis do .NET
Silverlight
Disponível desde 2.0
Windows Phone Silverlight
Disponível desde 7.0
Windows Phone
Disponível desde 8.1

Os membros estáticos públicos (Shared no Visual Basic) desse são thread-safe. Não há garantia de que qualquer membro de instância seja thread-safe.

Esta implementação não oferece um sincronizado wrapper (thread-safe) para um Array; no entanto, classes do .NET Framework com base em Array fornecer sua própria versão sincronizada de coleção usando o SyncRoot propriedade.

A enumeração por meio de uma coleção não é um procedimento thread-safe intrínseco. Mesmo quando uma coleção está sincronizada, outros threads ainda podem modificar a coleção, o que faz o enumerador lançar uma exceção. Para garantir thread-safe durante a enumeração, é possível bloquear a coleção durante toda a enumeração ou verificar as exceções resultantes das alterações feitas por outros threads.

Retornar ao início
Mostrar: