BitArray 類別

參考

定義

命名空間:: System.Collections

組件:: System.Collections.dll

組件:: mscorlib.dll

組件:: netstandard.dll

來源:: BitArray.cs

來源:: BitArray.cs

來源:: BitArray.cs

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

管理以布林 (Boolean) 表示的位元值之精簡陣列，其中 true 表示位元為開啟 (1)，而 false 表示位元為關閉 (0)。

public ref class BitArray sealed : System::Collections::ICollection

public ref class BitArray sealed : ICloneable, System::Collections::ICollection

public sealed class BitArray : System.Collections.ICollection

public sealed class BitArray : ICloneable, System.Collections.ICollection

[System.Serializable]
public sealed class BitArray : ICloneable, System.Collections.ICollection

[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public sealed class BitArray : ICloneable, System.Collections.ICollection

type BitArray = class
    interface ICollection
    interface IEnumerable

type BitArray = class
    interface ICollection
    interface IEnumerable
    interface ICloneable

[<System.Serializable>]
type BitArray = class
    interface ICollection
    interface IEnumerable
    interface ICloneable

[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type BitArray = class
    interface ICollection
    interface IEnumerable
    interface ICloneable

Public NotInheritable Class BitArray
Implements ICollection

Public NotInheritable Class BitArray
Implements ICloneable, ICollection

繼承: Object
BitArray

屬性: SerializableAttribute ComVisibleAttribute

實作: ICollection IEnumerable ICloneable

範例

下列程式代碼範例示範如何建立和初始化， BitArray 以及如何列印出其值。

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

備註

類別 BitArray 是集合類別，容量一律與計數相同。元素會藉由增加 Length 屬性來新增至 BitArray ;藉由減少 Length 屬性來刪除專案。 BitArray大小是由用戶端所控制;在結尾的BitArray ArgumentException索引擲回。類別 BitArray 提供在其他集合中找不到的方法，包括允許使用篩選一次修改多個元素的方法，例如 And、 Or、 Xor 、 Not和 SetAll。

類別 BitVector32 是一種結構，可提供與 BitArray相同的功能，但效能較快。 BitVector32 速度較快，因為它是實值型別，因此配置在堆疊上，而 BitArray 是參考型別，因此配置在堆積上。

System.Collections.Specialized.BitVector32 可以只儲存 32 位，而 BitArray 可以儲存可變的位數。 BitVector32 同時儲存位旗標和小型整數，因此非常適合不會向使用者公開的數據。不過，如果必要的位旗標數目未知、為變數或大於 32，請改用 BitArray 。

BitArray 位於 System.Collections 命名空間中; BitVector32 位於命名空間中 System.Collections.Specialized 。

這個集合中的元素可以使用整數索引來存取。此集合中的索引是以零起始。

建構函式

BitArray(BitArray)	初始化 BitArray 類別的新執行個體，其包含的位元值是從指定的 BitArray 複製過來的。
BitArray(Boolean[])	初始化 BitArray 類別的新執行個體，其包含的位元值是從指定的布林陣列複製過來的。
BitArray(Byte[])	初始化 BitArray 類別的新執行個體，其包含的位元值是從指定的位元組陣列複製過來的。
BitArray(Int32)	初始化 BitArray 類別的新執行個體，這個執行個體可保存指定數目的位元值 (其初始設定為 `false`)。
BitArray(Int32, Boolean)	初始化 BitArray 類別的新執行個體，其可以保存指定位元值數目 (初始設定為指定的值)。
BitArray(Int32[])	初始化 BitArray 類別的新執行個體，其包含的位元值是從指定的 32 位元整數陣列複製過來的。

屬性

Count	取得 BitArray 中所包含的項目數。
IsReadOnly	取得值，指出 BitArray 是否唯讀。
IsSynchronized	取得值，這個值表示對 BitArray 的存取是否同步 (安全執行緒)。
Item[Int32]	取得或設定在 BitArray 中特定位置的位元值。
Length	取得或設定 BitArray 中的項目數。
SyncRoot	取得可用以同步存取 BitArray 的物件。

方法

And(BitArray)	在指定陣列之目前 BitArray 物件的元素與對應元素之間執行位元 AND 運算。會修改目前的 BitArray 物件以儲存位元 AND 運算的結果。
Clone()	建立 BitArray 的淺層複本。
CopyTo(Array, Int32)	從目標陣列的指定索引開始，將整個 BitArray 複製到相容的一維 Array。
Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
Get(Int32)	取得 BitArray 中指定位置的位元值。
GetEnumerator()	傳回在 BitArray 中逐一查看的列舉值。
GetHashCode()	做為預設雜湊函式。 (繼承來源 Object)
GetType()	取得目前執行個體的 Type。 (繼承來源 Object)
HasAllSet()	判斷中的所有 BitArray 位是否都設定為 `true`。
HasAnySet()	判斷中的任何 BitArray 位是否設定為 `true`。
LeftShift(Int32)	將目前 BitArray 的所有位元值移至 `count` 位元左邊。
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
Not()	反轉目前 BitArray 中的位元值，使得設定為 `true` 的元素變更為 `false`，並且設定為 `false` 的元素變更為 `true`。
Or(BitArray)	在指定陣列之目前 BitArray 物件的元素與對應元素之間執行位元 OR 運算。會修改目前的 BitArray 物件以儲存位元 OR 運算的結果。
RightShift(Int32)	將目前 BitArray 的所有位元值移至 `count` 位元右邊。
Set(Int32, Boolean)	將 BitArray 中特定位置的位元設定為指定值。
SetAll(Boolean)	將 BitArray 中的所有位元設定為指定值。
ToString()	傳回代表目前物件的字串。 (繼承來源 Object)
Xor(BitArray)	針對指定陣列中的對應元素，在目前 BitArray 物件的元素之間執行位元排除 OR 運算。會修改目前的 BitArray 物件以儲存位元排除 OR 運算的結果。

明確介面實作

ICollection.CopyTo(Array, Int32)	從指定的 BitArray 索引位置開始，將 Array 的項目複製到 Array。
ICollection.Count	取得 BitArray 中的項目數目。
ICollection.IsSynchronized	取得值，這個值會指出 BitArray 的存取是否同步 (具備安全執行緒)。
ICollection.SyncRoot	取得可用以同步存取 BitArray 的物件。

擴充方法

Cast<TResult>(IEnumerable)	將 IEnumerable 的項目轉換成指定的型別。
OfType<TResult>(IEnumerable)	根據指定的型別來篩選 IEnumerable 的項目。
AsParallel(IEnumerable)	啟用查詢的平行化作業。
AsQueryable(IEnumerable)	將 IEnumerable 轉換成 IQueryable。

適用於

執行緒安全性

Visual Basic 中的公用靜態 (Shared) 此類型的成員是安全線程。並非所有的執行個體成員都是安全執行緒。

此實作不提供的同步處理 (線程安全) 包裝函式 BitArray。

透過集合進行列舉在本質上並非安全執行緒程序。即使集合經過同步化，其他的執行緒仍可修改該集合，使列舉值擲回例外狀況。若要保證列舉過程的執行緒安全，您可以在整個列舉過程中鎖定集合，或攔截由其他執行緒的變更所造成的例外狀況。

另請參閱

BitVector32

共用方式為