閱讀英文

共用方式為

StringDictionary 類別

  • 參考

定義

命名空間:
System.Collections.Specialized
組件:
System.dll, System.Collections.Specialized.dll
組件:
System.Collections.Specialized.dll
組件:
System.dll
組件:
netstandard.dll
來源:
StringDictionary.cs
來源:
StringDictionary.cs
來源:
StringDictionary.cs

使用強類型索引鍵和值，將雜湊資料表實作為字串，而非物件。

public class StringDictionary : System.Collections.IEnumerable
[System.Serializable]
public class StringDictionary : System.Collections.IEnumerable
繼承
Object
StringDictionary
屬性
SerializableAttribute
實作
IEnumerable

範例

下列程式代碼範例示範 的數個屬性和方法 StringDictionary。

using System;
using System.Collections;
using System.Collections.Specialized;

public class SamplesStringDictionary  {

   public static void Main()  {

      // Creates and initializes a new StringDictionary.
      StringDictionary myCol = new StringDictionary();
      myCol.Add( "red", "rojo" );
      myCol.Add( "green", "verde" );
      myCol.Add( "blue", "azul" );

      // Display the contents of the collection using foreach. This is the preferred method.
      Console.WriteLine( "Displays the elements using foreach:" );
      PrintKeysAndValues1( myCol );

      // Display the contents of the collection using the enumerator.
      Console.WriteLine( "Displays the elements using the IEnumerator:" );
      PrintKeysAndValues2( myCol );

      // Display the contents of the collection using the Keys, Values, Count, and Item properties.
      Console.WriteLine( "Displays the elements using the Keys, Values, Count, and Item properties:" );
      PrintKeysAndValues3( myCol );

      // Copies the StringDictionary to an array with DictionaryEntry elements.
      DictionaryEntry[] myArr = new DictionaryEntry[myCol.Count];
      myCol.CopyTo( myArr, 0 );

      // Displays the values in the array.
      Console.WriteLine( "Displays the elements in the array:" );
      Console.WriteLine( "   KEY        VALUE" );
      for ( int i = 0; i < myArr.Length; i++ )
         Console.WriteLine( "   {0,-10} {1}", myArr[i].Key, myArr[i].Value );
      Console.WriteLine();

      // Searches for a value.
      if ( myCol.ContainsValue( "amarillo" ) )
         Console.WriteLine( "The collection contains the value \"amarillo\"." );
      else
         Console.WriteLine( "The collection does not contain the value \"amarillo\"." );
      Console.WriteLine();

      // Searches for a key and deletes it.
      if ( myCol.ContainsKey( "green" ) )
         myCol.Remove( "green" );
      Console.WriteLine( "The collection contains the following elements after removing \"green\":" );
      PrintKeysAndValues1( myCol );

      // Clears the entire collection.
      myCol.Clear();
      Console.WriteLine( "The collection contains the following elements after it is cleared:" );
      PrintKeysAndValues1( myCol );
   }

   // Uses the foreach statement which hides the complexity of the enumerator.
   // NOTE: The foreach statement is the preferred way of enumerating the contents of a collection.
   public static void PrintKeysAndValues1( StringDictionary myCol )  {
      Console.WriteLine( "   KEY                       VALUE" );
      foreach ( DictionaryEntry de in myCol )
         Console.WriteLine( "   {0,-25} {1}", de.Key, de.Value );
      Console.WriteLine();
   }

   // Uses the enumerator.
   // NOTE: The foreach statement is the preferred way of enumerating the contents of a collection.
   public static void PrintKeysAndValues2( StringDictionary myCol )  {
      IEnumerator myEnumerator = myCol.GetEnumerator();
      DictionaryEntry de;
      Console.WriteLine( "   KEY                       VALUE" );
      while ( myEnumerator.MoveNext() )  {
         de = (DictionaryEntry) myEnumerator.Current;
         Console.WriteLine( "   {0,-25} {1}", de.Key, de.Value );
      }
      Console.WriteLine();
   }

   // Uses the Keys, Values, Count, and Item properties.
   public static void PrintKeysAndValues3( StringDictionary myCol )  {
      String[] myKeys = new String[myCol.Count];
      myCol.Keys.CopyTo( myKeys, 0 );

      Console.WriteLine( "   INDEX KEY                       VALUE" );
      for ( int i = 0; i < myCol.Count; i++ )
         Console.WriteLine( "   {0,-5} {1,-25} {2}", i, myKeys[i], myCol[myKeys[i]] );
      Console.WriteLine();
   }
}

/*
This code produces the following output.

Displays the elements using foreach:
   KEY                       VALUE
   red                       rojo
   blue                      azul
   green                     verde

Displays the elements using the IEnumerator:
   KEY                       VALUE
   red                       rojo
   blue                      azul
   green                     verde

Displays the elements using the Keys, Values, Count, and Item properties:
   INDEX KEY                       VALUE
   0     red                       rojo
   1     blue                      azul
   2     green                     verde

Displays the elements in the array:
   KEY        VALUE
   red        rojo
   blue       azul
   green      verde

The collection does not contain the value "amarillo".

The collection contains the following elements after removing "green":
   KEY                       VALUE
   red                       rojo
   blue                      azul

The collection contains the following elements after it is cleared:
   KEY                       VALUE

*/

備註

索引鍵不能是 null，但值可以。

索引鍵會以不區分大小寫的方式處理;它會在與字串字典搭配使用之前，先轉譯成小寫。

在 .NET Framework 1.0 版中，此類別會使用區分文化特性的字串比較。 不過，在 .NET Framework 1.1 版和更新版本中，這個類別會在比較字串時使用CultureInfo.InvariantCulture。 如需文化特性如何影響比較和排序的詳細資訊，請參閱 執行 Culture-Insensitive 字串作業。

建構函式

StringDictionary()

初始化 StringDictionary 類別的新執行個體。

屬性

Count

取得 StringDictionary 中的索引鍵/值組配對的數目。
IsSynchronized

取得值，這個值表示對 StringDictionary 的存取是否同步 (安全執行緒)。
Item[String]

取得或設定與指定之索引鍵相關聯的值。
Keys

取得 StringDictionary 中的索引鍵集合。
SyncRoot

取得可用以同步存取 StringDictionary 的物件。
Values

取得 StringDictionary 中的值集合。

方法

Add(String, String)

將有指定索引鍵和數值項目加入 StringDictionary 中。
Clear()

移除 StringDictionary 的所有項目。
ContainsKey(String)

判斷 StringDictionary 是否含有特定的索引鍵。
ContainsValue(String)

判斷 StringDictionary 是否含有特定值。
CopyTo(Array, Int32)

將字串字典值複製至在指定索引處的一維 Array 執行個體。
Equals(Object)

判斷指定的物件是否等於目前的物件。

(繼承來源 Object)
GetEnumerator()

傳回可對字串字典內容逐一查看的列舉程式。
GetHashCode()

做為預設雜湊函式。

(繼承來源 Object)
GetType()

取得目前執行個體的 Type。

(繼承來源 Object)
MemberwiseClone()

建立目前 Object 的淺層複製。

(繼承來源 Object)
Remove(String)

將具有指定索引鍵的項目從字串字典移除。
ToString()

傳回代表目前物件的字串。

(繼承來源 Object)

擴充方法

Cast<TResult>(IEnumerable)

將 IEnumerable 的項目轉換成指定的型別。
OfType<TResult>(IEnumerable)

根據指定的型別來篩選 IEnumerable 的項目。
AsParallel(IEnumerable)

啟用查詢的平行化作業。
AsQueryable(IEnumerable)

將 IEnumerable 轉換成 IQueryable。

適用於

產品 版本
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1
UWP 10.0

執行緒安全性

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

此實作不提供的同步處理 (線程安全) 包裝StringDictionary函式，但衍生類別可以使用 屬性建立自己的同步版本StringDictionarySyncRoot。

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

另請參閱