Exportar (0) Imprimir
Expandir todo
Este artículo proviene de un motor de traducción automática. Mueva el puntero sobre las frases del artículo para ver el texto original. Más información.
Traducción
Original

Array.BinarySearch (Método) (Array, Object, IComparer)

Busca un valor por toda una matriz unidimensional y ordenada, utilizando la interfaz IComparer especificada.

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

public static int BinarySearch(
	Array array,
	Object value,
	IComparer comparer
)

Parámetros

array
Tipo: System.Array
Matriz Array unidimensional y ordenada en la que se va a buscar.
value
Tipo: System.Object
Objeto que se va a buscar.
comparer
Tipo: System.Collections.IComparer
Implementación de IComparer que se va a utilizar al comparar elementos.
O bien
null para utilizar la implementación de IComparable de cada elemento.

Valor devuelto

Tipo: System.Int32
Índice del objeto value especificado en la matriz array especificada, si se encuentra el objeto value. Si no se encuentra value y value es menor que uno o varios elementos de array, un número negativo que es el complemento bit a bit del índice del primer elemento que sea mayor que value. Si no se encuentra value y value es mayor que cualquiera de los elementos de array, un número negativo que es el complemento bit a bit del índice del último elemento más uno.

ExcepciónCondición
ArgumentNullException

array es null.

RankException

array es multidimensional.

ArgumentException

comparer es null y value es de un tipo que no es compatible con los elementos de array.

InvalidOperationException

comparer es null, value no implementa la interfaz IComparable y la búsqueda encuentra un elemento que no implementa la interfaz IComparable.

Este método no permite buscar en matrices con índices negativos. Antes de llamar a este método, se debe ordenar array.

Si la matriz Array no contiene el valor especificado, el método devuelve un entero negativo. Puede aplicar el operador bit a bit de complemento (~ en C#, Not en Visual Basic) al resultado negativo para mostrar un índice. Si este índice es una unidad mayor que el límite superior de matriz, no hay elementos mayores que value en la matriz. En caso contrario, el índice corresponde al primer elemento que es mayor que value.

El comparador personaliza la forma en que se comparan los elementos. Por ejemplo, se puede utilizar System.Collections.CaseInsensitiveComparer como comparador para realizar búsquedas de cadenas sin distinguir mayúsculas de minúsculas.

Si comparer no es null, los elementos de array se comparan con el valor especificado utilizando la implementación de IComparer especificada. Los elementos de la matriz array ya deben estar ordenados de forma ascendente, siguiendo el criterio de ordenación definido por comparer; de lo contrario, el resultado podría ser incorrecto.

Si comparer es null, la comparación se realiza utilizando la implementación de IComparable proporcionada por el propio elemento o por el valor especificado. Los elementos de array ya deben estar ordenados de forma ascendente, siguiendo el criterio de ordenación definido por la implementación de IComparable; de lo contrario, el resultado puede ser incorrecto.

NotaNota

Si comparer es null y value no implementa la interfaz IComparable, los elementos de array no se prueban respecto de IComparable antes de que comience la búsqueda. Si la función de búsqueda encuentra un elemento que no implementa IComparable, se produce una excepción.

Se permiten elementos duplicados. Si Array contiene varios elementos iguales a value, el método solo devuelve el índice de una de las apariciones, no necesariamente la primera.

null se puede comparar siempre con cualquier otro tipo de referencia, por lo tanto, las comparaciones con null no generan excepciones.

NotaNota

   Para cada elemento probado, se pasa value a la implementación de IComparable adecuada, aún cuando value sea null. Es decir, la implementación de IComparable determina cómo se compara un elemento especificado con null.

Este método es una operación O(log n), donde n es Length de array.

.NET Framework

Compatible con: 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Compatible con: 4, 3.5 SP1

Biblioteca de clases portable

Compatible con: Biblioteca de clases portable

.NET para aplicaciones de la Tienda Windows

Compatible con: Windows 8

.NET para aplicaciones de Windows Phone

Compatible con: Windows Phone 8, Silverlight 8.1

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 (no se admite el rol Server Core), Windows Server 2008 R2 (se admite el rol Server Core con SP1 o versiones posteriores; no se admite Itanium)

.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

Adiciones de comunidad

AGREGAR
Mostrar:
© 2014 Microsoft