BitArray Classe

Definizione

Gestisce una matrice compatta di valori di bit, rappresentati come booleani, dove true indica che il bit è attivo (1), mentre false indica che il bit è inattivo (0).Manages a compact array of bit values, which are represented as Booleans, where true indicates that the bit is on (1) and false indicates the bit is off (0).

public ref class BitArray sealed : ICloneable, System::Collections::ICollection
[System.Runtime.InteropServices.ComVisible(true)]
[System.Serializable]
public sealed class BitArray : ICloneable, System.Collections.ICollection
type BitArray = class
    interface ICollection
    interface ICloneable
    interface IEnumerable
Public NotInheritable Class BitArray
Implements ICloneable, ICollection
Ereditarietà
BitArray
Attributi
Implementazioni

Esempi

Nell'esempio di codice seguente viene illustrato come creare e inizializzare un BitArray e come stamparne i valori.The following code example shows how to create and initialize a BitArray and how to print out its values.

using namespace System;
using namespace System::Collections;
void PrintValues( IEnumerable^ myList, int myWidth );
int main()
{
   
   // Creates and initializes several BitArrays.
   BitArray^ myBA1 = gcnew BitArray( 5 );
   BitArray^ myBA2 = gcnew BitArray( 5,false );
   array<Byte>^myBytes = {1,2,3,4,5};
   BitArray^ myBA3 = gcnew BitArray( myBytes );
   array<Boolean>^myBools = {true,false,true,true,false};
   BitArray^ myBA4 = gcnew BitArray( myBools );
   array<Int32>^myInts = {6,7,8,9,10};
   BitArray^ myBA5 = gcnew BitArray( myInts );
   
   // Displays the properties and values of the BitArrays.
   Console::WriteLine( "myBA1" );
   Console::WriteLine( "   Count:    {0}", myBA1->Count );
   Console::WriteLine( "   Length:   {0}", myBA1->Length );
   Console::WriteLine( "   Values:" );
   PrintValues( myBA1, 8 );
   Console::WriteLine( "myBA2" );
   Console::WriteLine( "   Count:    {0}", myBA2->Count );
   Console::WriteLine( "   Length:   {0}", myBA2->Length );
   Console::WriteLine( "   Values:" );
   PrintValues( myBA2, 8 );
   Console::WriteLine( "myBA3" );
   Console::WriteLine( "   Count:    {0}", myBA3->Count );
   Console::WriteLine( "   Length:   {0}", myBA3->Length );
   Console::WriteLine( "   Values:" );
   PrintValues( myBA3, 8 );
   Console::WriteLine( "myBA4" );
   Console::WriteLine( "   Count:    {0}", myBA4->Count );
   Console::WriteLine( "   Length:   {0}", myBA4->Length );
   Console::WriteLine( "   Values:" );
   PrintValues( myBA4, 8 );
   Console::WriteLine( "myBA5" );
   Console::WriteLine( "   Count:    {0}", myBA5->Count );
   Console::WriteLine( "   Length:   {0}", myBA5->Length );
   Console::WriteLine( "   Values:" );
   PrintValues( myBA5, 8 );
}

void PrintValues( IEnumerable^ myList, int myWidth )
{
   int i = myWidth;
   IEnumerator^ myEnum = myList->GetEnumerator();
   while ( myEnum->MoveNext() )
   {
      Object^ obj = safe_cast<Object^>(myEnum->Current);
      if ( i <= 0 )
      {
         i = myWidth;
         Console::WriteLine();
      }

      i--;
      Console::Write( "{0,8}", obj );
   }

   Console::WriteLine();
}

/* 
 This code produces the following output.
 
 myBA1
    Count:    5
    Length:   5
    Values:
    False   False   False   False   False
 myBA2
    Count:    5
    Length:   5
    Values:
    False   False   False   False   False
 myBA3
    Count:    40
    Length:   40
    Values:
     True   False   False   False   False   False   False   False
    False    True   False   False   False   False   False   False
     True    True   False   False   False   False   False   False
    False   False    True   False   False   False   False   False
     True   False    True   False   False   False   False   False
 myBA4
    Count:    5
    Length:   5
    Values:
     True   False    True    True   False
 myBA5
    Count:    160
    Length:   160
    Values:
    False    True    True   False   False   False   False   False
    False   False   False   False   False   False   False   False
    False   False   False   False   False   False   False   False
    False   False   False   False   False   False   False   False
     True    True    True   False   False   False   False   False
    False   False   False   False   False   False   False   False
    False   False   False   False   False   False   False   False
    False   False   False   False   False   False   False   False
    False   False   False    True   False   False   False   False
    False   False   False   False   False   False   False   False
    False   False   False   False   False   False   False   False
    False   False   False   False   False   False   False   False
     True   False   False    True   False   False   False   False
    False   False   False   False   False   False   False   False
    False   False   False   False   False   False   False   False
    False   False   False   False   False   False   False   False
    False    True   False    True   False   False   False   False
    False   False   False   False   False   False   False   False
    False   False   False   False   False   False   False   False
    False   False   False   False   False   False   False   False
 */
using System;
using System.Collections;
public class SamplesBitArray  {

   public static void Main()  {

      // Creates and initializes several BitArrays.
      BitArray myBA1 = new BitArray( 5 );

      BitArray myBA2 = new BitArray( 5, false );

      byte[] myBytes = new byte[5] { 1, 2, 3, 4, 5 };
      BitArray myBA3 = new BitArray( myBytes );

      bool[] myBools = new bool[5] { true, false, true, true, false };
      BitArray myBA4 = new BitArray( myBools );

      int[]  myInts  = new int[5] { 6, 7, 8, 9, 10 };
      BitArray myBA5 = new BitArray( myInts );

      // Displays the properties and values of the BitArrays.
      Console.WriteLine( "myBA1" );
      Console.WriteLine( "   Count:    {0}", myBA1.Count );
      Console.WriteLine( "   Length:   {0}", myBA1.Length );
      Console.WriteLine( "   Values:" );
      PrintValues( myBA1, 8 );

      Console.WriteLine( "myBA2" );
      Console.WriteLine( "   Count:    {0}", myBA2.Count );
      Console.WriteLine( "   Length:   {0}", myBA2.Length );
      Console.WriteLine( "   Values:" );
      PrintValues( myBA2, 8 );

      Console.WriteLine( "myBA3" );
      Console.WriteLine( "   Count:    {0}", myBA3.Count );
      Console.WriteLine( "   Length:   {0}", myBA3.Length );
      Console.WriteLine( "   Values:" );
      PrintValues( myBA3, 8 );

      Console.WriteLine( "myBA4" );
      Console.WriteLine( "   Count:    {0}", myBA4.Count );
      Console.WriteLine( "   Length:   {0}", myBA4.Length );
      Console.WriteLine( "   Values:" );
      PrintValues( myBA4, 8 );

      Console.WriteLine( "myBA5" );
      Console.WriteLine( "   Count:    {0}", myBA5.Count );
      Console.WriteLine( "   Length:   {0}", myBA5.Length );
      Console.WriteLine( "   Values:" );
      PrintValues( myBA5, 8 );
   }

   public static void PrintValues( IEnumerable myList, int myWidth )  {
      int i = myWidth;
      foreach ( Object obj in myList ) {
         if ( i <= 0 )  {
            i = myWidth;
            Console.WriteLine();
         }
         i--;
         Console.Write( "{0,8}", obj );
      }
      Console.WriteLine();
   }

}


/* 
This code produces the following output.

myBA1
   Count:    5
   Length:   5
   Values:
   False   False   False   False   False
myBA2
   Count:    5
   Length:   5
   Values:
   False   False   False   False   False
myBA3
   Count:    40
   Length:   40
   Values:
    True   False   False   False   False   False   False   False
   False    True   False   False   False   False   False   False
    True    True   False   False   False   False   False   False
   False   False    True   False   False   False   False   False
    True   False    True   False   False   False   False   False
myBA4
   Count:    5
   Length:   5
   Values:
    True   False    True    True   False
myBA5
   Count:    160
   Length:   160
   Values:
   False    True    True   False   False   False   False   False
   False   False   False   False   False   False   False   False
   False   False   False   False   False   False   False   False
   False   False   False   False   False   False   False   False
    True    True    True   False   False   False   False   False
   False   False   False   False   False   False   False   False
   False   False   False   False   False   False   False   False
   False   False   False   False   False   False   False   False
   False   False   False    True   False   False   False   False
   False   False   False   False   False   False   False   False
   False   False   False   False   False   False   False   False
   False   False   False   False   False   False   False   False
    True   False   False    True   False   False   False   False
   False   False   False   False   False   False   False   False
   False   False   False   False   False   False   False   False
   False   False   False   False   False   False   False   False
   False    True   False    True   False   False   False   False
   False   False   False   False   False   False   False   False
   False   False   False   False   False   False   False   False
   False   False   False   False   False   False   False   False
*/ 

Imports System.Collections

Public Class SamplesBitArray

    Public Shared Sub Main()

        ' Creates and initializes several BitArrays.
        Dim myBA1 As New BitArray(5)

        Dim myBA2 As New BitArray(5, False)

        Dim myBytes() As Byte = {1, 2, 3, 4, 5}
        Dim myBA3 As New BitArray(myBytes)

        Dim myBools() As Boolean = {True, False, True, True, False}
        Dim myBA4 As New BitArray(myBools)

        Dim myInts() As Integer = {6, 7, 8, 9, 10}
        Dim myBA5 As New BitArray(myInts)

        ' Displays the properties and values of the BitArrays.
        Console.WriteLine("myBA1")
        Console.WriteLine("   Count:    {0}", myBA1.Count)
        Console.WriteLine("   Length:   {0}", myBA1.Length)
        Console.WriteLine("   Values:")
        PrintValues(myBA1, 8)

        Console.WriteLine("myBA2")
        Console.WriteLine("   Count:    {0}", myBA2.Count)
        Console.WriteLine("   Length:   {0}", myBA2.Length)
        Console.WriteLine("   Values:")
        PrintValues(myBA2, 8)

        Console.WriteLine("myBA3")
        Console.WriteLine("   Count:    {0}", myBA3.Count)
        Console.WriteLine("   Length:   {0}", myBA3.Length)
        Console.WriteLine("   Values:")
        PrintValues(myBA3, 8)

        Console.WriteLine("myBA4")
        Console.WriteLine("   Count:    {0}", myBA4.Count)
        Console.WriteLine("   Length:   {0}", myBA4.Length)
        Console.WriteLine("   Values:")
        PrintValues(myBA4, 8)

        Console.WriteLine("myBA5")
        Console.WriteLine("   Count:    {0}", myBA5.Count)
        Console.WriteLine("   Length:   {0}", myBA5.Length)
        Console.WriteLine("   Values:")
        PrintValues(myBA5, 8)

    End Sub

    Public Shared Sub PrintValues(myList As IEnumerable, myWidth As Integer)
        Dim i As Integer = myWidth
        Dim obj As [Object]
        For Each obj In  myList
            If i <= 0 Then
                i = myWidth
                Console.WriteLine()
            End If
            i -= 1
            Console.Write("{0,8}", obj)
        Next obj
        Console.WriteLine()
    End Sub

End Class


' This code produces the following output.
' 
' myBA1
'    Count:    5
'    Length:   5
'    Values:
'    False   False   False   False   False
' myBA2
'    Count:    5
'    Length:   5
'    Values:
'    False   False   False   False   False
' myBA3
'    Count:    40
'    Length:   40
'    Values:
'     True   False   False   False   False   False   False   False
'    False    True   False   False   False   False   False   False
'     True    True   False   False   False   False   False   False
'    False   False    True   False   False   False   False   False
'     True   False    True   False   False   False   False   False
' myBA4
'    Count:    5
'    Length:   5
'    Values:
'     True   False    True    True   False
' myBA5
'    Count:    160
'    Length:   160
'    Values:
'    False    True    True   False   False   False   False   False
'    False   False   False   False   False   False   False   False
'    False   False   False   False   False   False   False   False
'    False   False   False   False   False   False   False   False
'     True    True    True   False   False   False   False   False
'    False   False   False   False   False   False   False   False
'    False   False   False   False   False   False   False   False
'    False   False   False   False   False   False   False   False
'    False   False   False    True   False   False   False   False
'    False   False   False   False   False   False   False   False
'    False   False   False   False   False   False   False   False
'    False   False   False   False   False   False   False   False
'     True   False   False    True   False   False   False   False
'    False   False   False   False   False   False   False   False
'    False   False   False   False   False   False   False   False
'    False   False   False   False   False   False   False   False
'    False    True   False    True   False   False   False   False
'    False   False   False   False   False   False   False   False
'    False   False   False   False   False   False   False   False
'    False   False   False   False   False   False   False   False

Commenti

La classe BitArray è una classe di raccolte in cui la capacità è sempre uguale al conteggio.The BitArray class is a collection class in which the capacity is always the same as the count. Gli elementi vengono aggiunti a un BitArray aumentando la proprietà Length; gli elementi vengono eliminati diminuendo la proprietà Length.Elements are added to a BitArray by increasing the Length property; elements are deleted by decreasing the Length property. La dimensione di un BitArray è controllata dal client; l'indicizzazione oltre la fine del BitArray genera una ArgumentException. La classe BitArray fornisce metodi che non sono disponibili in altre raccolte, inclusi quelli che consentono di modificare contemporaneamente più elementi usando un filtro, ad esempio And, Or, Xor, Not e SetAll.The size of a BitArray is controlled by the client; indexing past the end of the BitArray throws an ArgumentException.The BitArray class provides methods that are not found in other collections, including those that allow multiple elements to be modified at once using a filter, such as And, Or, Xor , Not, and SetAll.

La classe BitVector32 è una struttura che fornisce le stesse funzionalità di BitArray, ma con prestazioni più elevate.The BitVector32 class is a structure that provides the same functionality as BitArray, but with faster performance. BitVector32 è più veloce perché è un tipo di valore e pertanto allocato nello stack, mentre BitArray è un tipo di riferimento e, pertanto, allocato nell'heap.BitVector32 is faster because it is a value type and therefore allocated on the stack, whereas BitArray is a reference type and, therefore, allocated on the heap.

System.Collections.Specialized.BitVector32 può archiviare esattamente 32 bit, mentre BitArray può archiviare un numero variabile di bit.System.Collections.Specialized.BitVector32 can store exactly 32 bits, whereas BitArray can store a variable number of bits. BitVector32 archivia sia i flag di bit che i valori integer piccoli, rendendoli quindi ideali per i dati non esposti all'utente.BitVector32 stores both bit flags and small integers, thereby making it ideal for data that is not exposed to the user. Tuttavia, se il numero di flag di bit richiesti è sconosciuto, è variabile o è maggiore di 32, usare invece BitArray.However, if the number of required bit flags is unknown, is variable, or is greater than 32, use BitArray instead.

BitArray è nello spazio dei nomi System.Collections; BitVector32 si trova nello spazio dei nomi System.Collections.Specialized.BitArray is in the System.Collections namespace; BitVector32 is in the System.Collections.Specialized namespace.

È possibile accedere agli elementi di questa raccolta usando un indice Integer.Elements in this collection can be accessed using an integer index. Gli indici in questa raccolta sono in base zero.Indexes in this collection are zero-based.

Costruttori

BitArray(BitArray)

Inizializza una nuova istanza della classe BitArray che contiene i valori di bit copiati dall'oggetto BitArray specificato.Initializes a new instance of the BitArray class that contains bit values copied from the specified BitArray.

BitArray(Boolean[])

Inizializza una nuova istanza della classe BitArray contenente i valori di bit copiati dalla matrice specificata di valori booleani.Initializes a new instance of the BitArray class that contains bit values copied from the specified array of Booleans.

BitArray(Byte[])

Inizializza una nuova istanza della classe BitArray contenente i valori di bit copiati dalla matrice di byte specificata.Initializes a new instance of the BitArray class that contains bit values copied from the specified array of bytes.

BitArray(Int32)

Inizializza una nuova istanza della classe BitArray che può contenere il numero specificato di valori di bit, inizialmente impostato su false.Initializes a new instance of the BitArray class that can hold the specified number of bit values, which are initially set to false.

BitArray(Int32, Boolean)

Inizializza una nuova istanza della classe BitArray che può contenere il numero specificato di valori di bit, inizialmente impostato sul valore specificato.Initializes a new instance of the BitArray class that can hold the specified number of bit values, which are initially set to the specified value.

BitArray(Int32[])

Inizializza una nuova istanza della classe BitArray contenente i valori di bit copiati dalla matrice specificata di valori interi a 32 bit.Initializes a new instance of the BitArray class that contains bit values copied from the specified array of 32-bit integers.

Proprietà

Count

Ottiene il numero di elementi contenuti in BitArray.Gets the number of elements contained in the BitArray.

IsReadOnly

Ottiene un valore che indica se BitArray è di sola lettura.Gets a value indicating whether the BitArray is read-only.

IsSynchronized

Ottiene un valore che indica se l'accesso a BitArray è sincronizzato (thread-safe).Gets a value indicating whether access to the BitArray is synchronized (thread safe).

Item[Int32]

Ottiene o imposta il valore del bit in una specifica posizione nella BitArray.Gets or sets the value of the bit at a specific position in the BitArray.

Length

Ottiene o imposta il numero di elementi nella BitArray.Gets or sets the number of elements in the BitArray.

SyncRoot

Ottiene un oggetto che può essere usato per sincronizzare l'accesso a BitArray.Gets an object that can be used to synchronize access to the BitArray.

Metodi

And(BitArray)

Esegue l'operazione con AND bit per bit tra gli elementi dell'oggetto BitArray corrente e gli elementi corrispondenti nella matrice specificata.Performs the bitwise AND operation between the elements of the current BitArray object and the corresponding elements in the specified array. L'oggetto BitArray corrente verrà modificato per archiviare il risultato dell'operazione con AND bit per bit.The current BitArray object will be modified to store the result of the bitwise AND operation.

Clone()

Crea una copia superficiale di BitArray.Creates a shallow copy of the BitArray.

CopyTo(Array, Int32)

Copia l'intero oggetto BitArray in un oggetto Array compatibile unidimensionale, a partire dall'indice specificato della matrice di destinazione.Copies the entire BitArray to a compatible one-dimensional Array, starting at the specified index of the target array.

Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.Determines whether the specified object is equal to the current object.

(Ereditato da Object)
Get(Int32)

Ottiene il valore del bit in una posizione specifica nella BitArray.Gets the value of the bit at a specific position in the BitArray.

GetEnumerator()

Restituisce un enumeratore che esegue l'iterazione di BitArray.Returns an enumerator that iterates through the BitArray.

GetHashCode()

Funge da funzione hash predefinita.Serves as the default hash function.

(Ereditato da Object)
GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Ereditato da Object)
LeftShift(Int32)
MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Ereditato da Object)
Not()

Consente di invertire tutti i valori dei bit nella BitArray corrente in modo che gli elementi impostati su true diventino false e gli elementi impostati su false diventino true.Inverts all the bit values in the current BitArray, so that elements set to true are changed to false, and elements set to false are changed to true.

Or(BitArray)

Esegue l'operazione con OR bit per bit tra gli elementi dell'oggetto BitArray corrente e gli elementi corrispondenti nella matrice specificata.Performs the bitwise OR operation between the elements of the current BitArray object and the corresponding elements in the specified array. L'oggetto BitArray corrente verrà modificato per archiviare il risultato dell'operazione con OR bit per bit.The current BitArray object will be modified to store the result of the bitwise OR operation.

RightShift(Int32)
Set(Int32, Boolean)

Imposta il bit in una posizione specifica nell'oggetto BitArray sul valore specificato.Sets the bit at a specific position in the BitArray to the specified value.

SetAll(Boolean)

Imposta tutti i bit dell'oggetto BitArray sul valore specificato.Sets all bits in the BitArray to the specified value.

ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.Returns a string that represents the current object.

(Ereditato da Object)
Xor(BitArray)

Esegue l'operazione con OR esclusivo bit per bit tra gli elementi dell'oggetto BitArray corrente e gli elementi corrispondenti nella matrice specificata.Performs the bitwise exclusive OR operation between the elements of the current BitArray object against the corresponding elements in the specified array. L'oggetto BitArray corrente verrà modificato per archiviare il risultato dell'operazione con OR esclusivo bit per bit.The current BitArray object will be modified to store the result of the bitwise exclusive OR operation.

Implementazioni dell'interfaccia esplicita

ICollection.CopyTo(Array, Int32)

Copia gli elementi dell'oggetto BitArray in un oggetto Array, a partire da un indice Array specificato.Copies the elements of the BitArray to an Array, starting at the specified Array index.

ICollection.Count

Ottiene il numero di elementi in BitArray.Gets the number of elements in the BitArray.

ICollection.IsSynchronized

Ottiene un valore che indica se l'accesso a BitArray è sincronizzato (thread-safe).Gets a value that indicates whether access to the BitArray is synchronized (thread safe).

ICollection.SyncRoot

Ottiene un oggetto che può essere usato per sincronizzare l'accesso a BitArray.Gets an object that can be used to synchronize access to the BitArray.

Metodi di estensione

Cast<TResult>(IEnumerable)

Esegue il cast degli elementi di un oggetto IEnumerable nel tipo specificato.Casts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable)

Filtra gli elementi di un oggetto IEnumerable in base a un tipo specificato.Filters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable)

Consente la parallelizzazione di una query.Enables parallelization of a query.

AsQueryable(IEnumerable)

Converte un oggetto IEnumerable in un oggetto IQueryable.Converts an IEnumerable to an IQueryable.

Si applica a

Thread safety

I membri statici pubblici (Shared in Visual Basic) di questo tipo sono thread-safe.Public static (Shared in Visual Basic) members of this type are thread safe. I membri di istanza non sono garantiti come thread-safe.Any instance members are not guaranteed to be thread safe.

Questa implementazione non fornisce un wrapper sincronizzato (thread-safe) per un BitArray.This implementation does not provide a synchronized (thread safe) wrapper for a BitArray.

L'enumerazione di una raccolta non è di per sé una procedura thread-safe.Enumerating through a collection is intrinsically not a thread-safe procedure. Anche se una raccolta è sincronizzata, è possibile che venga modificata da altri thread, con conseguente generazione di un'eccezione da parte dell'enumeratore.Even when a collection is synchronized, other threads can still modify the collection, which causes the enumerator to throw an exception. Per garantire la protezione dei thread durante l'enumerazione, è possibile bloccare la raccolta per l'intera enumerazione oppure intercettare le eccezioni determinate dalle modifiche apportate da altri thread.To guarantee thread safety during enumeration, you can either lock the collection during the entire enumeration or catch the exceptions resulting from changes made by other threads.

Vedi anche