SortedList<TKey,TValue>.IDictionary.Item[Object] Properti

Definisi

Ruang nama:

System.Collections.Generic

Rakitan:

System.Collections.dll

Sumber:

SortedList.cs

Mendapatkan atau mengatur elemen dengan kunci yang ditentukan.

property System::Object ^ System::Collections::IDictionary::Item[System::Object ^] { System::Object ^ get(System::Object ^ key); void set(System::Object ^ key, System::Object ^ value); };

object? System.Collections.IDictionary.Item[object key] { get; set; }

member this.System.Collections.IDictionary.Item(obj) : obj with get, set

 Property Item(key As Object) As Object Implements IDictionary.Item

Parameter

key

Object

Kunci elemen untuk mendapatkan atau mengatur.

Nilai Properti

Object

Elemen dengan kunci yang ditentukan, atau null jika key tidak ada dalam kamus atau key berjenis yang tidak dapat ditetapkan ke jenis TKeySortedList<TKey,TValue>kunci .

Penerapan

Item[Object]

Pengecualian

ArgumentNullException

keyadalah null.

ArgumentException

Nilai sedang ditetapkan, dan key merupakan jenis yang tidak dapat ditetapkan ke jenis TKeySortedList<TKey,TValue>kunci .

-atau-

Nilai sedang ditetapkan, dan value merupakan jenis yang tidak dapat ditetapkan ke jenis TValueSortedList<TKey,TValue>nilai .

Contoh

Contoh kode berikut menunjukkan cara menggunakan IDictionary.Item[] properti (pengindeks di C#) System.Collections.IDictionary antarmuka dengan SortedList<TKey,TValue>, dan cara properti berbeda dari SortedList<TKey,TValue>.Item[] properti .

Contoh menunjukkan bahwa, seperti SortedList<TKey,TValue>.Item[] properti , SortedList<TKey,TValue>.IDictionary.Item[] properti dapat mengubah nilai yang terkait dengan kunci yang ada dan dapat digunakan untuk menambahkan pasangan kunci/nilai baru jika kunci yang ditentukan tidak ada dalam daftar yang diurutkan. Contohnya juga menunjukkan bahwa tidak seperti SortedList<TKey,TValue>.Item[] properti , SortedList<TKey,TValue>.IDictionary.Item[] properti tidak memberikan pengecualian jika key tidak ada dalam daftar yang diurutkan, mengembalikan referensi null sebagai gantinya. Terakhir, contoh menunjukkan bahwa mendapatkan SortedList<TKey,TValue>.IDictionary.Item[] properti mengembalikan referensi null jika key bukan jenis data yang benar, dan pengaturan tersebut menampilkan pengecualian jika key bukan jenis data yang benar.

Contoh kode adalah bagian dari contoh yang lebih besar, termasuk output, yang disediakan untuk metode .IDictionary.Add

using System;
using System.Collections;
using System.Collections.Generic;

public class Example
{
    public static void Main()
    {
        // Create a new sorted list of strings, with string keys,
        // and access it using the IDictionary interface.
        //
        IDictionary openWith = new SortedList<string, string>();

        // Add some elements to the sorted list. There are no
        // duplicate keys, but some of the values are duplicates.
        // IDictionary.Add throws an exception if incorrect types
        // are supplied for key or value.
        openWith.Add("txt", "notepad.exe");
        openWith.Add("bmp", "paint.exe");
        openWith.Add("dib", "paint.exe");
        openWith.Add("rtf", "wordpad.exe");

Imports System.Collections
Imports System.Collections.Generic

Public Class Example
    
    Public Shared Sub Main() 

        ' Create a new sorted list of strings, with string keys,
        ' and access it using the IDictionary interface.
        '
        Dim openWith As IDictionary = _
            New sortedList(Of String, String)
        
        ' Add some elements to the sorted list. There are no 
        ' duplicate keys, but some of the values are duplicates.
        ' IDictionary.Add throws an exception if incorrect types
        ' are supplied for key or value.
        openWith.Add("txt", "notepad.exe")
        openWith.Add("bmp", "paint.exe")
        openWith.Add("dib", "paint.exe")
        openWith.Add("rtf", "wordpad.exe")

// The Item property is another name for the indexer, so you
// can omit its name when accessing elements.
Console.WriteLine("For key = \"rtf\", value = {0}.",
    openWith["rtf"]);

// The indexer can be used to change the value associated
// with a key.
openWith["rtf"] = "winword.exe";
Console.WriteLine("For key = \"rtf\", value = {0}.",
    openWith["rtf"]);

// If a key does not exist, setting the indexer for that key
// adds a new key/value pair.
openWith["doc"] = "winword.exe";

// The indexer returns null if the key is of the wrong data
// type.
Console.WriteLine("The indexer returns null"
    + " if the key is of the wrong type:");
Console.WriteLine("For key = 2, value = {0}.",
    openWith[2]);

// The indexer throws an exception when setting a value
// if the key is of the wrong data type.
try
{
    openWith[2] = "This does not get added.";
}
catch (ArgumentException)
{
    Console.WriteLine("A key of the wrong type was specified"
        + " when assigning to the indexer.");
}

' The Item property is the default property, so you 
' can omit its name when accessing elements. 
Console.WriteLine("For key = ""rtf"", value = {0}.", _
    openWith("rtf"))

' The default Item property can be used to change the value
' associated with a key.
openWith("rtf") = "winword.exe"
Console.WriteLine("For key = ""rtf"", value = {0}.", _
    openWith("rtf"))

' If a key does not exist, setting the default Item property
' for that key adds a new key/value pair.
openWith("doc") = "winword.exe"

' The default Item property returns Nothing if the key
' is of the wrong data type.
Console.WriteLine("The default Item property returns Nothing" _
    & " if the key is of the wrong type:")
Console.WriteLine("For key = 2, value = {0}.", _
    openWith(2))

' The default Item property throws an exception when setting
' a value if the key is of the wrong data type.
Try
    openWith(2) = "This does not get added."
Catch 
    Console.WriteLine("A key of the wrong type was specified" _
        & " when setting the default Item property.")
End Try

// Unlike the default Item property on the SorteList class
// itself, IDictionary.Item does not throw an exception
// if the requested key is not in the sorted list.
Console.WriteLine("For key = \"tif\", value = {0}.",
    openWith["tif"]);

' Unlike the default Item property on the SortedList class
' itself, IDictionary.Item does not throw an exception
' if the requested key is not in the sorted list.
Console.WriteLine("For key = ""tif"", value = {0}.", _
    openWith("tif"))

    }
}

    End Sub

End Class

Keterangan

Properti ini mengembalikan jika key berjenis null yang tidak dapat ditetapkan ke jenis TKeySortedList<TKey,TValue>kunci .

Properti ini menyediakan kemampuan untuk mengakses elemen tertentu dalam koleksi dengan menggunakan sintaks berikut: myCollection[key].

Anda juga dapat menggunakan Item[] properti untuk menambahkan elemen baru dengan mengatur nilai kunci yang tidak ada dalam kamus; misalnya, myCollection["myNonexistentKey"] = myValue. Namun, jika kunci yang ditentukan sudah ada dalam kamus, mengatur Item[] properti akan menimpa nilai lama. Sebaliknya, Add metode tidak memodifikasi elemen yang ada.

Bahasa C# menggunakan kata kunci ini untuk menentukan pengindeks alih-alih mengimplementasikan IDictionary.Item[] properti . Visual Basic mengimplementasikan IDictionary.Item[] sebagai properti default, yang menyediakan fungsionalitas pengindeksan yang sama.

Mengambil nilai properti ini adalah operasi O(log n), di mana n adalah Count. Mengatur properti adalah operasi O(log n) jika kunci sudah ada di SortedList<TKey,TValue>. Jika kunci tidak ada dalam daftar, mengatur properti adalah operasi O(n) untuk data yang tidak diurutkan, atau O(log n) jika elemen baru ditambahkan di akhir daftar. Jika penyisipan menyebabkan pengurangan ukuran, operasinya adalah O(n).

Lihat juga

• Item[TKey]
• Add(Object, Object)